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Avant-propos 



La collection Atelier du webmaster s'adresse aux personnes initiees au developpement de 
sites web qui souhaitent decouvrir et mettre en pratique les nouvelles technologies 
Internet. Sans negliger les aspects theoriques, nous donnons toujours priorite a la pratique 
arm que vous puissiez rapidement etre autonome. 

A travers les differents titres de cette collection vous decouvrirez les technologies qui font 
le web 2.0 et feront ce que certains nomment deja le web 3.0. 

Conventions typographiques 

Ann de faciliter la comprehension des techniques decrites, nous avons adopte les 
conventions typographiques suivantes : 

gras : menu, commande, boite de dialogue, bouton, onglet. 

italique : zone de texte, liste deroulante, case a cocher, bouton radio. 

Police baton : instruction, listing, texte a saisir. 

**■ : dans les scripts, indique un retour a la ligne volontaire du aux contraintes de la 

mise en page. 

(D^ 

II s'agit cl'informations complementaires relatives au sujet traite. Propose conseils et trues pratiques. 



Mise en garde sur un point important a ne pas negliger. 
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Preface 



Bonjour et merci pour l'investissement que vous venez d'effectuer. Vous allez decouvrir 
dans cet ouvrage certaines extensions de PHP5 dont on parle beaucoup, mais qui sont tres 
peu utilisees. Vous allez decouvrir egalement des extensions internes a PHP construites en 
C et compilees arm d'etre integrees dans le moteur de PHP (Zend). L'avantage de ces 
extensions par rapport aux bibliotheques programmers en PHP (PEAR par exemple) est 
leur rapidite. Elles ne seront pas toutes traitees en un seul ouvrage, le manuel PHP en 
repertoriant, a l'heure ou ces lignes sont ecrites, cent quatre-vingt cinq. Le choix a ete 
porte uniquement sur celles documentees dans le manuel officiel de PHP. Cette decision 
tient au fait que nous pensons qu'il est beaucoup plus important et utile d'enseigner a 
quelqu'un a cuisiner plutot que de le nourrir toute sa vie. Vous allez done decouvrir 
beaucoup de cas pratiques et assez peu de theorie, celle-ci etant deja publiee sur des 
millions de pages web et dans une innombrable quantite de livres. 

Cet ouvrage est divise en chapitres qui contiennent chacun un theme et plusieurs sections. 
Certains chapitres sont tres courts et d'autres beaucoup plus longs. La raison en est que 
certaines extensions comme BZIP2 ne comportent qu'une dizaine de fonctions et aucune 
constante predefinie ni directive de configuration a placer dans le flchier php.ini, et que 
d'autres extensions contiennent plus d'une centaine de fonctions ainsi qu'un grand 
nombre de constantes et des directives de configuration. 

Pour certains chapitres, il y a un cas pratique, presente en fin de chapitre, et celui-ci est 
parfois experimente selon plusieurs methodes arm de laisser au lecteur le choix pour 
integrer une methode plus qu'une autre dans un projet. Le cas pratique a pour objectif de 
vous fournir un exemple utilisable a l'interieur d'un cas reel, et done concret : site 
Internet, applications Intranet/extranet ; et cela en utilisant ces fameuses extensions qui 
sont (trop ?) souvent omises. C'est-a-dire que vous pouvez recuperer le code et le 
copier/coller. Vous devrez probablement aussi le modifier quelque peu, pour l'utiliser 
dans un (ou plusieurs) de vos projets. 

Le chapitre 1 montre l'interet de compresser des fichiers contenant du texte avec 
l'extension BZIP2 arm de gagner de la place sur le disque dur et d'utiliser ZIP pour placer 
des fichiers dans une archive, toujours dans l'objectif de gagner de l'espace disque. 
L'extension ZLIB sera egalement decrite en fin de ce chapitre, juste avant le cas pratique. 

Le chapitre 2 prouve que PHP n'est pas en reste en ce qui concerne la communication 
avec des logiciels de bureautique tels Word, Excel et les equivalents OpenOffice.org. 
Nous vous expliquerons comment creer une feuille Microsoft Excel contenant un 
graphique trouvant ses donnees dans une base MySQL, ainsi qu'une methode, certes 
empirique mais extremement efficace, pour interpreter des macros Visual Basic en PHP. 
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Nous vous presenterons egalement DOM, puissante extension gerant le XML, dans le but 
de creer des documents OpenOffice.org. 

Le chapitre 3, quant a lui, vous explique comment manipuler les images et vous permettra 
de prendre conscience des fonctions tres puissantes qu'offre PHP dans ce domaine avec 
la possibilite de creer des dessins complexes. 

Le chapitre 4 est consacre a la generation des fichiers PDF : textes dynamiques ou 
statiques, images, signets... En somme, une petite boite a outils pour les documents 
destines a vos utilisateurs. 

Le chapitre 5 est une decouverte du monde LDAP et de ses avantages et inconvenients 
par rapport a une base de donnees. 

Le chapitre 6 aborde justement le domaine BDD (Bases de donnees) avec PDO {PHP 
Data Object) qui permet avec les memes fonctions de se connecter a n'importe quel 
SGBDR (Systeme de gestion de base de donnees) : MySQL, PostgreSQL, Oracle, etc. 

Le chapitre 7 decrit les fonctions des extensions Classkit et Runkit. Vous apprendrez 
comment ecrire du code dynamique et l'interet de le faire. 

Le chapitre 8 poussera un peu plus loin avec Ref 1 ecti on qui est une exception a la regie. 
Reflection n'est pas une extension interne a PHP mais une API {Application 
Programming Interface). 

Le chapitre 9 se consacre au systeme de cache et vous montrera comment accelerer 
l'affichage de pages dynamiques tout en soulageant votre serveur. 

Le chapitre 10 montre comment creer du code illisible humainement puisque compile. 
C'est l'extension Bcompiler qui s'en charge, le tout pour proteger vos algorithmes. 

Le chapitre 11 decrit une methode pour etudier une nouvelle extension encore non 
acquise. Vous comprendrez comment les auteurs de ce livre s'y prennent pour etudier et 
assimiler une extension non encore documented. 

II ne vous reste plus qu'a tourner les pages, et faire ainsi un magnifique voyage dans le 
monde des extensions internes a PHP. Nous vous souhaitons de faire des decouvertes 
enrichissantes dans ce domaine. 



Objectifs du livre 



Ce livre a pour objectif de vous eclairer sur les extensions de PHP tres peu usitees. Ces 
extensions nous ont pourtant ete tres utiles lors de la creation de certains projets effectues 
dans un passe plus ou moins lointain. Pour decouvrir ces extensions et les maitriser 
toutes, il nous a fallu du temps. Beaucoup de temps. Et aussi des plantages. Enormement 
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de plantages. II est dit que c'est la meilleure facon de progresses Sans compter le temps 
que nous avons passe a chercher les informations pour, a la fois trouver les bonnes 
extensions et les documentations. Le temps, c'est ce que, par le biais de cet ouvrage, nous 
desirons vous faire economises Nous le faisons aussi dans l'esprit PHP qui est de fournir 
nos decouvertes sans rien cacher. Vous permettre de gagner du temps, de 1' argent et des 
efforts parfois inutiles pour trouver des informations qui, au bout du compte, ne sont pas 
celles dont vous avez besoin. 

Nous vous conseillons de considerer ce livre comme un dictionnaire. Dans un 
dictionnaire, vous cherchez un mot precis. Dans ce livre, c'est la meme chose au niveau 
des informations. Vous desirez une information sur la compression de fichiers ? 
Rendez-vous au chapitre 1. Vous desirez utiliser l'API de reflexion ? Allez jeter un ceil au 
chapitre 8. Vous voulez savoir comment faire pour trouver les informations et comment 
on etudie une nouvelle extension afin de la maitriser ? Vous decouvrirez tout dans le 
chapitre Methodologie. Consultez directement le chapitre consacre au sujet qui vous 
interesse. Vous desirez retrouver un cas pratique afin de l'adapter a l'un de vos projets, 
allez-y, ces exemples sont totalement fibres de droits et nous y tenons. Vous desirez nous 
poser des questions, ecrivez-nous, nos adresses e-mail sont a votre disposition (dans la 
section A propos des auteurs de cette preface), ainsi, bien stir, que nos oreilles. 

Tels sont les objectifs de ce livre. Et s'il vous manque des informations, si vous auriez 
redige telle ou telle section autrement, ou si encore vous avez le moindre argument a 
formuler, n'hesitez pas a nous le faire savoir ! 



A qui s'adresse ce livre ? 



En voila une drole de question ! Un livre sur les extensions de PHP ne peut s'adresser 
qu'aux developpeurs PHP. Cela semble logique et d'une evidence certaine ? Rien n'est 
moins sur : quels developpeurs PHP ? Les bons, les tres bons, les debutants ? On ne peut 
pas dire qu'un certain niveau soit requis, car un developpeur debutant pourra trouver son 
compte dans ce livre, pourvu qu'il sache ce qu'est une fonction ou une boucle 
conditionnelle. Le developpeur confirme, lui, trouvera des explications claires et rapides 
sur des extensions que nous avons selectionnees car elles nous ont permis de repondre a 
de nombreux problemes. Le principal interet est que cela se traduira par un inevitable 
gain de temps dans la realisation de vos projets. 

Finalement, ce livre s'adresse a ceux qui veulent en connaitre plus sur PHP comme a ceux 
qui ont une problematique precise et qu'une extension du langage PHP pourrait resoudre. 
II peut etre vu comme "une formation a l'utifisation des extensions", car il offre des 
connaissances sur les principales extensions de PHP, puis propose des methodologies 
permettant d'apprehender de nouvelles extensions par soi-meme et d'elargir encore son 
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savoir et ses competences. Ce livre peut egalement etre utilise comme un dictionnaire, et 
permettre a chacun de prendre ici et la des morceaux de codes, et la comprehension qui 
va avec, afin d'enrichir considerablement ses propres realisations et/ou celles des autres. 

A propos des auteurs 
David Drapeau 

Developpeur autodidacte au parcours atypique et eclectique (manutentionnaire, musicien, 
magasinier, hypnotherapeute, formateur en informatique et en communication...), David 
Drapeau est tombe dans l'univers de la programmation quand il etait petit. Aujourd'hui, 
il se consacre entierement a PHP5 et attend avec impatience PHP6 dont il teste deja les 
nouveautes depuis le mois d' aout 2007. II etudie egalement, pendant son temps libre, tout 
ce qui peut entrer en interaction avec PHP tels OpenLaszlo, AJAX et tout ce qui touche 
de pres ou de loin le domaine Internet : webmarketing, securite informatique, 
algorithmes. II est egalement passionne par les mathematiques qu'il pratique pour 
s'amuser quand il lui reste un peu de temps libre. 

Pour le joindre : david.drapeau@gmai 1 .com 

Frederic Suire 

Frederic Suire s'est interesse des son plus jeune age, tout comme David Drapeau, au 
monde de la programmation. II a lui aussi suivi un parcours atypique, passant d' etudes 
litteraires a des etudes scientifiques, d'etudes musicales a des etudes artistiques. 
Aujourd'hui, il est developpeur web independant et maitrise, plus par passion que par 
necessite, un grand nombre de langages destines a l'lnternet (du HTML au PHP, du 
JavaScript a 1'ActionScript, et bien d'autres encore). Par la meme, peu de logiciels de 
graphisme lui sont inconnus. Son cheval de bataille favori ? Le developpement 
d'interfaces homme-machine, ou il peut s'amuser aussi bien graphiquement qu'en 
programmation. 

Pour le joindre : frederic@suire.info 
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Compresser, 
c'estgagner... 




II est assez frequent de reprendre des projets qui 
possedent une partie de I'application qui comprend la 
gestion des fichiers. Et ces fichiers sont bien souvent, pour 
ne pas dire tout le temps, au format texte [.txt], PDF [.pdl), 
et meme au format Excel (.x/s). C'est Id tout I'interet des 
algorithmes de compression. 



Compresser, c'est gagner. 



1.1 BZIP2 : compresser des donnees 

Evidemment, ces fichiers prennent enormement de place sur le serveur (le hardware) et 
tout le monde n'a pas les moyens de se payer un serveur dedie. Pourtant, certains sites 
amateurs sont tres bien fournis au niveau du contenu avec des liens internes vers des 
fichiers .pdf ou .xls pour des graphiques et des tableaux. 

Aujourd'hui, de tres nombreux formats de compression existent : .zip, -tar, .gz, .tgz, -rar, 
.bz2, .ace et bien d'autres encore. Dans ce chapitre, vous allez decouvrir trois formats 
compiles dans PHP : BZIP2, ZIP et ZLIB. Leurs avantages : puisque programmes en C et 
compiles avec PHP, il en ressort une grande rapidite d'execution. En premier lieu, nous 
allons vous decrire BZIP2 qui permet de compresser des donnees en quelques lignes de 
code et d'y acceder de nouveau ulterieurement tout aussi rapidement. Puis suivra ZIP, la 
plus consequente des trois extensions PHP etudiees dans ce chapitre. ZIP contient 
beaucoup de constantes predefinies (plus d'une quarantaine) et de fonctions (environ une 
quarantaine). ZLIB completera ce chapitre avec 1' etude de toutes ses fonctions. 

Comme c'est en forgeant qu'on devient forgeron, vous ne trouverez que tres peu de 
theorie. Beaucoup de sites Internet s'en chargent. Tout au long de ce livre, vous trouverez 
peu de discours et beaucoup de code. 

BZIP2 est une extension interne a PHP (programmee en C done) qui utilise la 
bibliotheque creee par Julian Seward et qui a vu le jour au milieu des annees 90. Cette 
bibliotheque cree des fichiers compresses a partir de l'algorithme de Burrows-Wheeler 
associe au codage de Huffman : l'extension des fichiers crees est .bz2. 

Q) Tous les exemples verifies et testes 

Tous les programmes preserves dans ce livre ont ete testes avec XAMPP 1 .6.2 sur Windows XP avec 
XAMPP installe dans C:\Program Files\. 



Creation d'un document 



Ouverture 



La premiere fonction a utiliser pour creer le premier document BZIP est celle d'ouverture 
d'un fichier .bz2 en mode Ecriture. Pour faire cela, c'est la fonction bzopen() qui s'y 
prete. 

resource bzopen(chaine $nom fichier, chaine $mode ouverture) 
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BZIP2 : compresser des donnees 



$mode_ouverture doit avoir pour valeur r (lecture) ou w (ecriture). Dans le cas du mode 
Ecriture, si le fichier n'existe pas, il est cree. 

<?php // Debut du script creer bzip2.php 
// On ouvre un fichier nomme exemple . bzip2 
$bzo = bzopen ( ' . /f ichiers/exemple .bz2 ' , "w"); 

Fermeture 

Puis, comme pour les fichiers texte, le fichier est ferme grace a la fonction bzclose(). 
int bzclose(resource $bzo) 

Le parametre $bzo est l'identifiant de connexion defini lors de l'appel de la fonction 
bzopen(). 

^^ BZ_creer.php 

// On ferme le fichier bzip2 

$bzc = bzclose ($bzo) ; 

?> 

Lors de l'execution du script BZ_creer.php par le biais de votre navigateur favori, le script 
PHP va creer un fichier nomme exemple. bz2. 

Compression 

Les fonctions indispensables a tous les fichiers, ouverture et fermeture, ont ete etudiees. 
Entrons maintenant dans le vif du sujet avec l'etude de la fonction de compression 
bzcompress(). 

mixte bzcompress(chaine $donnees [, entier $taux_compression [, entier 
$f acteur_de_travai 1 ] ] ) 

bzcompressO compresse la chaine $donnees et retourne les donnees encodees ou un 
numero d'erreur en cas d'echec lors de la procedure de compression. Le taux de 
compression est affecte au parametre $taux_compression qui possede une valeur qui peut 
varier de 1 a 9. 9 represente le meilleur taux de compression mais s'avere un peu plus lent 
que 1 qui a par contre un petit taux de compression. $facteur_de_travail controle le 
comportement de la compression. Sa valeur par defaut est 34 et est une valeur speciale. 
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Compresser, c'est gagner. 



^j BZ_compression.php 

<?php 

$texte =<«lecontenuduf ichier 

Placez ici un texte de plus d' une dizaine de lignes afin de mieux vous 

*» rendre compte de la compression. 

lecontenuduf ichier; 

// Le texte brut 
echo $texte . '<br/>'; 

// Le texte compresse 
$bzcomp = bzcompress ($ texte) ; 
echo $bzcomp; 

?> 



BZh41AY&SW-???^5@?@@?''#0 ?1@D ?Ee&8 SrE8PV- Resultat dans le 

navigateur de 



>> Fig. 1.1 : 

Resultat da 
navigateur 
reto u r_bzco mpress.php 



Decompression 

Decompresser des donnees BZIP2 est d'une simplicite enfantine. II suffit simplement de 
faire appel a la fonction bzdecompress() dont la syntaxe est la suivante : 

mixed bzdecompress(chaine $donnees_compressees[, entier $small]) 

La fonction bzdecompress() decompresse les donnees $donnees_compresses qui ont ete 
compressees avec la fonction bzcompress (). 

$smal 1 permet de choisir entre le mode par defaut (si $smal 1 = f al se) ou un autre mode 
(si $ small = true) de decompression qui prend peu de memoire mais est plus lent a 
1' execution. 

(J) Documentation officielle 

Vous pouvez vous referer a la documentation officielle en anglais a I'adresse suivante : 
http://www.bzip.Org/l.0.3/bzip2-manual-l.0.3.html. 
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BZIP2 : compresser des donnees 



Ecriture 

Cependant, bzcompress() n'ecrit pas les donnees compressees dans le fichier .bz2. La 
fonction donne juste un apercu des donnees telles qu'elles seront integrees dans le fichier 
compresse. II est temps maintenant de voir comment inserer les donnees dans le fichier 
exemple.bz2. Pour effectuer cette manipulation, l'utilisation de la fonction bzwrite() 
s'avere necessaire. 

entier bzwrite(resource $bzo, chaine $donnees [, entier $nb_caract_max] ) ecrit 
dans le fichier $bzo les donnees $donnees dont il est possible d'imposer une limite de 
caracteres grace au parametre optionnel $nb_caract_max. L'utilisation de la fonction 
bzwrite() est visible dans le script suivant : 



J^£ BZ_ecriture.php 



<?php 

// Ouverture 

$bzo = bzopen ( ' . /f ichiers/exemple .bz2 ' , "w"); 

$texte =<«lecontenuduf ichier 
le con tenudu fichier; 

// Ecriture dans le fichier compresse 

// int bzwrite ( resource bz, string data [, int length] ) 

bzwrite ($bzo, $texte, strlen ($texte) ) ; 

$bzc = bzclose ($bzo) ; 
?> 



Lecture 

Gagner de la place est une chose et acceder de nouveau a des donnees en est une autre. 
Pourquoi gagner de la place s'il faut ensuite un grand nombre de lignes de code pour 
acceder a nouveau aux donnees ? Eh bien, c'est tout aussi simple de lire des donnees pour 
un fichier compresse en .bz2 qu'en Jxt. 

Pour la lecture d'un fichier compresse en .bz2, la responsabilite en revient a la fonction 
bzread(). 

chaine bzread (resource $bzo[, entier $nb caract max] ) 
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*^ BZjecture.php 

<?php 

$file = " . /f ichiers/dynamisez_php .bz2 " ; 

$bzo = bzopen ($f ile, "r") or die ("Impossible d' ouvrir le fichier $file"); 

$decompresser fichier = ' ' ; 
while (!feof ($bzo) ) { 

$decompresser fichier .= bzread($bzo, f ilesize ($f ile) ) ; 
} 

bzclose ($bzo) ; 

echo "Le contenu du fichier $file est : <br />\n"; 

echo stripslashes ( $decompresser fichier); 

?> 

Pour l'instant, les donnees affichees sont toujours compressees et leur lecture est 
incomprehensible pour un esprit normalement constitue. II est done necessaire de 
decompresser les donnees afin de rendre la lecture comprehensible a tout un chacun. 

Pour cela, il suffit juste de modifier la ligne : 

echo stripslashes ( $decompresser fichier); 

Et de proceder de la facon suivante : 

echo stripslashes (bzdecompress ( $decompresser fichier)); 

Maintenant, dans le meme repertoire fichiers, creez un fichier dynamisez_php. txt et 
faites un copier/coller du texte original (non compresse) dans ce fichier texte. Nous 
insistons sur le fait qu'il s'agit d'un copier/coller pour etre certain que le contenu soit 
identique afin de rendre credible la demonstration. Vous vous retrouvez done dans le 
repertoire fichiers avec dynamisez.jphp.hz2 et dynamisez_php.txt. 

Placez le curseur de la souris sur le fichier .bz2 et regardez sa taille (en octets) puis 
faites de meme sur le fichier .txt. Vous pouvez voir qu'avec si peu de contenu, il y 
a deja une difference assez nette entre les deux fichiers, le fichier compresse etant 
bien entendu le plus leger. Imaginez maintenant la difference de taille par rapport a 
un fichier .txt de plusieurs Ko et ce pour un repertoire de plusieurs dizaines, voire 
centaines de fichiers. Vous visualisez le gain d'espace disque economise sur le 
serveur ? Voici la difference que cela donne sur le poste suivant : 
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dynamisez_php. txt 
Document texte 
1 Ko 



Type : Archive WinRAR 

Date de modification : 09/09/2007 09:50 | 

Taille : 4G5 octets 



► Fig. 1.2: 

La taille du fichier 
compresse 




dynamisez_php.bz2 
Archive WinRAR 
1 Ko 



Fig. 1.3: 

La taille du fichier texte 



Type : Document texte I 

Date de modification : 10/09/2007 09:00 
Taille : 503 octets 



Gestion des erreurs 

bzerror/ bzerrno/bzerrstr 

tableau bzerror(resource $bz) 
entier bzerrno(resource $bz) 
chaine bzerrstr(resource $bz) 

La fonction bzerror () retourne un tableau qui contient a la fois le numero et le message 
d'erreur. Les noms des cles sont errno pour le numero d'erreur et errstr pour le 
message d'erreur. 

Les fonctions bzerrno() et bzerrstr() retournent respectivement le numero et le 
message d'erreur sans avoir a utiliser la fonction bzerror () : 

^^ BZ_bzerror.php 

<?php 

$file = " . /f ichiers/dynamisez_php .bz2 " ; 

$bzo = bzopen ($f ile, "r"); 

if ( ! bzwrite ($bzo, "ecriture impossible en mode lecture"))! 
$bze = bzerror ( $bzo) ; 

echo ' <pre>' ; 
print r ($bze ) ; 
echo ' </pre>' ; 



bzclose ($bzo) ; 
?> 
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Vous pouvez recuperer les memes informations par les cles errno et errstr de la maniere 
suivante : 



^j BZ_errno_errstr.php 














<?php 
$file = 
$bzo = 


" . /f ichiers/dynamisez 
bzopen ($f ile, "r"); 


php . bz2 " , 












if ( ! bzwrite ( $bzo, "ecriture impossible 
$bze = bzerror ( $bzo) ; 


en 


mc 


de 


lecture' 


)) { 


echo 
} 


$bze [' errno' ] .'<br/>' 


$bze [ ' errst 


r' 


] ; 






bzclose 
?> 


($bzo) ; 















La troisieme methode utilise les fonctions bzerrno() et bzerror() comme le montre le 
script bzerrno_bz.errorstr.php : 

^* BZ_bzerrno_bzerrstr.php 

<?php 

$file = " . /f ichiers/dynamisez_php .bz2" ; 

$bzo = bzopen ($file, "r") ; 

if (! bzwrite ( $bzo, "ecriture impossible en mode lecture"))! 
$bzerrno = bzerrno ($bzo) ; 
$bzerrstr = bzerrstr ($bzo) ; 

echo $bzerrno .'<br/>'. $bzerrstr; 
} 

bzclose ($bzo) ; 
?> 

Vous pouvez vous apercevoir qu'il est tres facile de gerer des fichiers compresses a l'aide 
de la bibliotheque BZIP2. Cependant, ce n'est pas la seule bibliotheque disponible pour 
PHP dont 1' extension est programmee en C. II en existe une autre qui contient plus de 
fonctions, et qui est par logique plus complete et plus complexe : il s'agit de ZIP. C'est 
1' extension la plus connue et la plus utilisee. Peut-etre aussi la plus ancienne. Nous allons 
etudier cette extension et decouvrir ce qu'elle contient de plus par rapport a BZIP2. 
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1 .2 ZIP : creer des archives 

Tout d'abord, un peu d'histoire. Le format de compression ZIP a ete cree a la fin des 
annees 80 par Phil Katz. Pendant des annees, le format ZIP s'est impose comme un 
standard de compression. Ce qui etait normal, vu qu'il n'y avait pas de concurrence a 
l'epoque. Puis, sont venus tellement de formats de compression qu'il est difficile de ne 
pas en oublier un seul. Creer un fichier ZIP par le biais de PHP est tres simple. 

La premiere difference entre BZIP2 et ZIP est que BZIP2 permet de compresser du 
contenu textuel, c'est-a-dire des donnees, alors que ZIP permet de creer une archive (un 
dossier compresse en quelque sorte) et d'y placer des fichiers, des repertoires. L' autre 
grande difference est que ZIP fonctionne en version objet. 

Compression 

Voici un exemple tres simple de la creation d'une archive dans laquelle deux fichiers 
crees precedemment avec BZIP2, dynamisez_php.bz2 et dynamisez_php.txt, vont etre 
inseres. Le programme est tres court et, chose courante en PHP, il est tres simple : 



*♦ 


ZA_addFile.php 




<?php 








// Or 


cree 


une instance de la classe 


ZipArchive 


$zip 


= new 


ZipArchive ( ) ; 




// Or 


cree 


une archive ZIP 




// si 


elle 


n'existe pas, on la cree (ZIPARCHIVE :: CREATE) 


if ($zip->op 


en ( ' . /fichiers /exemple .zip' 


/ 






ZIPARCHIVE: : CREATE) === 


TRUE) { 


// 


On y insere le fichier dynamisez 


php . txt 


$zi 


p->addFile ( ' . /f ichiers/dynamisez 


php. txt' , 






'dynamisez php. txt'); 




// 


ainsi 


que le fichier exemple. bz2 




// 


que 1' 


on renomme php dynamique.b 


z2 


$zi 


p->addFile ( ' . /f ichiers/dynamisez 


php. bz2' , 






'php dynamique . bz2' ) ; 




// 


Et on 


ferme le fichier 




$zi 


p->close ( ) ; 




// 


Et voila, c'est aussi simple que 


cela . 


ech 


o 'ok' 


; 
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} else { 

echo ' echec' ; 
} 
?> 

Voici la syntaxe des fonctions utilisees : 

mixte ZipArchi ve: :open(chaTne nom_fichier[, entier drapeaux]) 

bool ZipArchi ve: :addFile(chaTne $nom_fichier[, chaTne $nom_dans_archive] ) 

bool ZipArchive: :close(void) 

Explications 

La premiere fonction utilisee est open(). Nous y reviendrons plus loin. La seconde 
fonction utilisee est addFi 1 e () qui va ajouter un fichier dans 1' archive ZIP. Le premier 
parametre, $nom_f i chi er, represente le nom du fichier existant, c'est-a-dire celui que Ton 
veut inserer dans l'archive. Le second parametre, $nom_local, est optionnel. II permet de 
renommer un nchier afin que son nom dans l'archive soit different du nom du nchier 
recupere en premier argument. Vous en avez un exemple lors de la deuxieme utilisation 
de la fonction addFi 1 e () dans le script creerjzip.php. 

Revenons maintenant a la fonction open (). Tout comme la fonction fopen() pour les 
fichiers texte, elle prend en premier argument le nom du nchier (archive ZIP) a ouvrir, ici 
exemple.zip. Le second argument est nouveau par rapport a la fonction open() des 
fichiers. II s'agit de flags (drapeaux). En fait, ce sont des constantes qui possedent une 
valeur numerique. Les constantes admises pour cette fonction sont les suivantes : 

ZipArchive: :CREATE : cree l'archive si elle n'existe pas. 
ZipArchive: :EXCL : genere une erreur si l'archive existe deja. 
I ZipArchi ve: :CHECKCONS : effectue des analyses supplementaires de consistances et 
emet une erreur si elles echouent. 

ZipArchive: :OVERWRITE : cree l'archive si elle n'existe pas et l'ecrase si elle existe 
deja. 

ZipArchive: :open() retourne une valeur mixed. II s'agit aussi de constantes dont une est 
booleenne (TRUE en cas de succes) et les autres sont de type int (les messages d'erreurs 
possibles en cas d'echec) : 

ZipArchive: :ER_EXISTS : erreur generee si le fichier existe deja. 
ZipArchive: :ER_INC0NS : archive ZIP inconsistante. 
ZipArchive: :ER_INVAL : argument invalide. 
ZipArchi ve: :ER MEMORY : echec d'allocation memoire. 
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ZipArchive: :ER_NOENT : erreur generee si le fichier n'existe pas. 
I ZipArchive: :ER_NOZIP : erreur generee s'il ne s'agit pas d'une archive ZIP. 

ZipArchive: :ER_OPEN : erreur generee s'il est impossible d'ouvrir le fichier. 

ZipArchive: :ER_READ : erreur de lecture. 
I ZipArchive: :ER_SEEK : erreur de pointeur. 

Les erreurs 

L'extension ZIPpossede des constantes predefinies dont certaines sont destinees a gerer 
les erreurs. Le script nomme retour_open.php tente d'ouvrir une archive ZIP en generant 
volontairement une erreur. L' erreur generee est recuperee grace a un switch-case qui 
prend en compte toutes les constantes de retour listees precedemment et permet de 
prendre connaissance du message d'erreur retourne lors de l'execution du fichier PHP 
dans le navigateur. Le code donne done : 

fl^ ZA_retour_open.php 

<?php 

$zip = new ZipArchive () ; 

$zo = $zip->open ( ' . /f ichiers/exemple . zip' , ZipArchive: :EXCL) ; 
if ($zo ! == true) { 
switch ($zo) { 

case ZipArchive: :ER_EXISTS: 

echo ' le fichier existe deja'; 

break; 
case ZipArchive: :ER_INCONS: 

echo 'archive ZIP inconsistante' ; 

break; 
case ZipArchive: :ER_INVAL: 

echo 'argument invalide' ; 

break; 
case ZipArchive: :ER_MEMORY: 

echo 'echec allocation memoire'; 

break; 
case ZipArchive: :ER_NOENT: 

echo 'fichier inexistant' ; 

break; 
case ZipArchive: :ER_NOZIP: 

echo 'non reconnue comme archive ZIP'; 

break; 
case ZipArchive: :ER_OPEN: 

echo ' ouverture fichier impossible'; 

break; 
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case ZipArchive 


: :ER 


READ: 






echo ' argumen 


t de 


lecture' 


; 




break; 










case ZipArchive 


: :ER 


SEEK: 






echo 'erreur 


de p 


Dinteur' ; 






break; 










default: 








} 
} 

//$ 


echo 'erreur 


incomprehensi 


ble' ; 


zip->close ( ) ; 








?> 











Le flag ZipArchive: :EXCL signifie que Ton veut ouvrir un fichier qui n'existe pas deja, 
done on veut en creer un nouveau. Ainsi, si le fichier que Ton essaie d'ouvrir existe, cela 
genere le message d'erreur suivant : 

Le fichier existe deja. 

Ce qui correspond a la valeur de retour ZipArchive: :ER_EXISTS. 

Appelons maintenant un fichier qui n'existe pas et voyons ce que cela donne : 

Ouverture fichier impossible. 

Ce qui correspond a la valeur de retour ZipArchive: :ER_0PEN. 

L'erreur retournee n'est pas seulement due au flag mais aussi au premier argument. 

Appelez, avec le premier argument, le fichier exemple.bzip2 et placez le flag 
ZipArchive: :CREATE ou ZipArchive: :CHECKCONS en second argument. L'erreur retournee 
est ZipArchive: :ER_N0ZIP. 

A present, remplacez CREATE par EXCL et cette fois l'erreur retournee est 
ZipArchive: :ER_EXISTS. 

Decompression 

La decompression d'une archive peut s'effectuer de plusieurs facons. La methode decrite 
dans cette section est l'utilisation de la fonction extracTo(). 

mixte ZipArchive: :extractTo(cha!ne $rep_dest[, mixte $entrees]) 

$rep_dest est le repertoire dans lequel les fichiers extraits seront inseres. $entrees s'ecrit 
sous forme de table si vous desirez extraire seulement quelques fichiers de 1' archive. Ce 
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second parametre etant optionnel, ne le renseignez pas si vous desirez extraire la totalite du 
contenu de 1' archive. Le script ZA_extractTo.php extrait les fichiers texte3.txt et texte4.txt 
de 1' archive et les place dans le repertoire textes. Si ce repertoire n'existe pas, il sera cree. 

Un exemple d'utilisation est donne dans la section Fonctions utiles - Extraire des 
fichiers d'une archive. 

Fonctions utiles 

Aj outer des fichiers crees en temps reel 

Vous avez vu comment inserer des fichiers existants dans une archive. Aussi, ZIP permet 
d'inserer des fichiers encore non existants et qui vont etre crees en temps reel. Cela 
permet de mieux dynamiser PHP en gerant par exemple un systeme de fichiers de logs 
(gestion des erreurs et exceptions) qui seront automatiquement compresses dans une 
archive. Le script ZA_addFromString.php cree une archive ZIP qui contient plusieurs 
fichiers . txt : 

^^ ZA_addFromString.php 

<?php 

$oZA = new ZipArchive ( ) ; 

$open = $oZA->open (' . /f ichiers/addFromString. zip' , ZIPARCHIVE :: CREATE) ; 
if ($open) { 

echo "creation de 1' archive et insertion des fichiers texte 

grace a la fonction addFromString ( ) . . . " ; 
$oZA->addFromString ( ' textel . txt' , ' Le premier texte ajoute grace a 

la fonction addFromString ()') ; 
$oZA->addFromString ( ' texte2 . txt' , ' Le deuxieme texte ajoute 

grace a la fonction addFromString ()') ; 
$oZA->addFromString ( ' texte3 . txt' , ' Le troisieme texte ajoute 

grace a la fonction addFromString ()') ; 
$oZA->addFromString ( ' texte4 . txt' , ' Le quatrieme texte ajoute 

grace a la fonction addFromString ()') ; 
echo 'ok<br/>'; 

$oZA->close () ; 
} else { 

echo ' echec' ; 
} 

?> 
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Apres avoir execute le fichier addFromString.php, une archive a ete creee dans le 
repertoire courant. Elle contient quatre fichiers texte nommes textel.txt, texte2.txt, 
texte3.txt et texte4.txt. 



fonctions.zip - WinRAR (Version devaluation) 



ISQ 



Fichier Commandes Outils Favoris Options Aide 



1x1 |@ fonctions.zip - ZIP archive, la taille non compressee est de 239 octets 




±b if S\ «&© & 



Ajouter Extraire vers Tester Voir Suppression Rechercher Assistant Info 



111 textel.txt 
(3 texte2.txt 
(3 texte3.txt 
(3 texte4.txt 



59 
58 
G1 
G1 



G1 Document texte 12/09/2007 

GO Document texte 12/09/2007 

G2 Document texte 12/09/2007 

G2 Document texte 12/09/2007 



.J -a 



Total 239 octets dans 4 fichiers 




4B1B17E2 
C132AE87 
6C0A02ED 
114E8FE1 



► Fig. 1 .4 : Les quatre fichiers texte de I'archive ZIP 

En etudiant le script precedent, il est tres aise de remarquer que la fonction qui permet 
de gerer du contenu en temps reel est addFromString(). 

bool ZipArchi ve: :addFromString(chaTne $nom_dans_archive, chaTne $contenu) 

Grace a la fonction addFromString() le contenu (texte) passe en second parametre 
($contenu) sera integre dans le fichier dont le nom est defini en premier parametre 
($nom_dans_archi ve) de la fonction. 

Extraire des fichiers d'une archive 

La fonction qui permet l'extraction de tout ou partie de I'archive est extractTo(). 
mixte ZipArchi ve: :extractTo(chaTne $destination[, mixte $entrees] ) 

Le script ZA_extractTo.php extrait les fichiers textel.txt et texte2.txt dans un repertoire 
nomme textes. Si ce repertoire n'existe pas, il est cree. Si ce repertoire existe et qu'il 
contient des fichiers portant le meme nom que ceux a extraire, alors les fichiers deja 
existants seront ecrases sans demande de confirmation. 



^j, ZA_extracflb.php 

<?php 

$oZA = new ZipArchive; 
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if ($oZA->open (' . /f ichiers/addFromString. zip' ) ) { 

echo 'Extraction des fichiers texte2.txt et texte3.txt' 
$oZA->extractTo (' . /f ichiers/textes/' , 

array ( ' texte2 . txt' , ' texte3 . txt' ) ) ; 
$oZA->close () ; 

} else { 

echo ' echec' ; 
} 
?> 



Renommer des fichiers contenus dans l'archive 

Grace a V index 

II est possible d'agir sur les fichiers et repertoires meme lorsque ceux-ci sont deja integres 
dans l'archive. II peut etre ainsi necessaire de renommer un fichier par le biais de son 
index. C'est la fonction renamelndex() qui s'en charge. 

bool ZipArchi ve: :renamelndex(entier $index, chaTne $nouveau_nom) 

La fonction renamelndex() va renommer le fichier qui a pour index $index defini en 
premier parametre et lui donner le nom $nouveau_nom defini en second parametre. 

^fL ZA_renamelndex.php 

<?php 

$oZA = new ZipArchive ( ) ; 

$open = $oZA->open ( ' . /f ichiers/addFromString. zip' , 

ZIPARCHIVE: : CREATE) ; 
if ($open) { 

// Renomme une entree definie par son index 

echo "renommage d'un texte par le biais de son index : 

renamelndex ( ) . . . " ; 
$oZA->renameIndex ( 1, "rename by index.txt"); 
echo 'ok<br/>'; 

$oZA->close () ; 
} else { 

echo ' echec' ; 
} 

?> 
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Une fois le fichier rename Index. php execute dans le navigateur, il vous reste a ouvrir 
1' archive addFromString.zip. Maintenant, le fichier nomme textel.php a ete renomme et 
F archive contient a la place un fichier nomme rename _by_index. txt. Renommez le fichier 
qui a pour nom texte4.txt. 

Grace au nom 

Vous venez de voir a l'instant meme comment renommer un fichier defini par son index. 
Vous pouvez effectuer la meme action avec un fichier defini par son nom. Comme 
toujours, les fonctions PHP sont tres simples a memoriser, leurs noms etant suffisamment 
explicites. Done, apres avoir vu renamelndex(), nous allons prendre en consideration 

renameName(). 

bool ZipArchive: :renameName(chaTne $nom_actuel , chaTne $nouveau_nom) 

La fonction renameName() prend en premier argument ($nom_actuel) le nom actuel du 
fichier cible contenu dans l'archive et en second argument ($nouveau_nom) le nouveau 
nom qui lui sera affecte. 

^* ZA_renameName.php 

<?php 

$oZA = new ZipArchive () ; 

$open = $oZA->open ( ' . /f ichiers/addFromString . zip' , 

ZIPARCHIVE: : CREATE) ; 
if ($open) { 

// Renomme une entree definie par son nom 

echo "renommage d'un texte par le biais de son nom : 

renameName ( ) . . . " ; 
$oZA->renameName ( ' texte4 . txt' , 'nouveau nom texte4.txt'); 
echo 'ok<br/>'; 

$oZA->close () ; 
} else { 

echo ' echec' ; 
} 

?> 

renameName. php renomme le fichier texte4.txt en nouveau_nom_texte4.txt. 
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Ajouter/Lire un commentaire a l'archive ZIP 

chaTne ZipArchive: :getArchiveComment() : recupere (lit) le commentaire associe a 

l'archive. 

mixte ZipArchive: :setArchiveComment(chaTne $commentaire) : ajoute (ecrit) un 

commentaire associe a l'archive courante. Le commentaire est une chaine de 

caracteres $commentaire placee en parametre de la fonction. 

*^jt ZA_commentaire.php 

<?php 

$oZA = new ZipArchive () ; 

$open = $oZA->open ( ' . /f ichiers/addFromString. zip' , 

ZIPARCHIVE: : CREATE) ; 
if ($open) { 

$readAC = $oZA->getArchiveComment ( ) ; 

echo "lecture du commentaire de l'archive ZIP : 

getArchiveComment () . . . <br/>"; 
echo '-> '. $readAC . '<br/>'; 

echo "ecriture d' un commentaire pour l'archive ZIP : 

setArchiveComment ( ) . . . <br/>"; 
$mix = $oZA->setArchiveComment ( ' le commentaire de fonctions.zip'); 

$readAC = $oZA->getArchiveComment ( ) ; 

echo "lecture du commentaire de l'archive ZIP : 

getArchiveComment ( ) . . . <br/>"; 
echo '-> '. $readAC .'<br/>'; 
} 

$oZA->close () ; 
?> 



Localiser une entree 

Vous avez vu precedemment que vous pouviez renommer un fichier en selectionnant ledit 
fichier par son nom ou bien par son index. La presence d'un index signifie que les fichiers 
sont ranges dans un ordre. Vous pouvez localiser l'emplacement d'un fichier dans une 
archive avec la fonction locateName(). 

mixte ZipArchive: :locateName(chaTne $nom_fichier[, entier $drapeaux]) 
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La methode locateName() va localiser 1' emplacement du fichier cible defini dans la 
variable $nom_fichier. Le second parametre, optionnel, est un drapeau auquel on affecte 
une constante predefmie parmi les suivantes : 

FLJOCASE 
FL_N0DIR 

FL_N0CASE ignore la casse sur le nom. En clair, elle ne fera pas la difference entre les 
lettres majuscules et les lettres minuscules. FL_N0DIR ignore le composant dossier. 

^j ZAJocateName.php 

<?php 

$oZA = new ZipArchive ( ) ; 

$open = $oZA->open ( ' . /f ichiers/addFromString . zip' , 

ZIPARCHIVE: : CREATE) ; 
if ($open) { 

echo "localisation d'une entree en utilisant son nom : 

locateName ( ) . . . <br />" ; 
$mix = $oZA->locateName ( ' texte3 . txt' ) ; 
echo $mix; // Affiche 2 
} 

$oZA->close () ; 
?> 

Vous avez pu etudier les principales fonctions de l'extension ZIP de PHP. II en existe 
d'autres et elles sont assez nombreuses. Reportez-vous au manuel PHP (http://php.net/) pour 
en prendre connaissance. II est temps de passer maintenant a ZLIB. 

1 .3 ZLIB : Quel est son secret ? 

Jetons un ceil rapide a cette bibliotheque. ZLIB a ete creee par Jean-Loup Gailly pour la 
compression et Mark Adler en ce qui concerne la decompression. ZLIB fonctionne sous 
toutes les plates-formes (Windows, Linux et autres). 

Fonctions ZLIB 

Ouverture/Fermeture 

Les syntaxes sont evidentes et ont ete vues maintes fois dans les autres extensions qui 
gerent les fichiers : 
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resource gzopen(chaTne $nom_fichier, chaTne $mode[, entier $use_include 
_path]) : ouvre un fichier compresse avec l'extension .gzip pour y ecrire ou y lire 
des donnees. 

bool gzclose (resource $gzo) : gzclose() referme le fichier $gzo ouvert avec la 
methode gzopen(). 



^£ GZ_creer.php 



<?php 

// Peut etre utilisee pour lire un fichier qui n'est pas 

// dans un format gzip ; dans ce cas, gzread() lira directement 

// le fichier sans decompression. 

$find in include path = 0; 

$gzo = gzopen ( ' . /test . gz ' , "w", $find in include path) 

or die ( ' Ouverture du fichier echouee' ) ; 
if (is_resource ($gzopen) ) { 

echo ' $gzopen est une ressource<br/>' ; 
} else { 

echo "\$gzopen = ". $gzopen .'<br/>'; 
} 

gzclose ($gzopen) ; 
?> 



Ecriture 

Les noms de fonctions ZLIB sont souvent identiques aux noms de fonctions de BZIP2. 
La seule difference se trouve dans la premiere lettre (b pour BZIP2 et g pour ZLIB). De 
plus, elles remplissent souvent (toujours ?) la meme action. Avec BZIP2, vous avez etudie 
bzwrite() pour ecrire dans un fichier. Pour ZLIB, le nom sera gzwrite(). Comme 
explique a la phrase precedente, seule la premiere lettre change. 

entier gzwrite(resource $gzo, chaTne $chaine [, entier $taille]) 

La fonction gzwrite() va ecrire dans la ressource (fichier .gz) definie dans le premier 
parametre. Le troisieme parametre ($tai 1 1 e) est optionnel et va permettre d'imposer une 
limite de taille pour la chaine a y inscrire. 

Pour pouvoir ecrire dans la ressource $gzo, il est necessaire que celle-ci soit ouverte en 
mode Ecriture : 
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^j GZ_ecriture.php 

<?php 

$chaine = "Bon jour tout le monde"; 

// Ouverture du fichier en mode ecriture 
$gzo = gzopen (' . /test . gz' , "w") 

or die (' Ouverture du fichier echouee'); 

// ecrit le contenu de la chaine string 
// dans le fichier compresse zp . 
gzwrite ($gzo, $ chaine ) ; 
unset ($chaine) ; 

gzclose ($gzo) ; 
?> 



Lecture 

Voici encore une fois un exemple tres simple pour savoir comment lire dans un fichier 
compresse par ZLIB. La fonction qui s'y prete est gzread(). 

chaTne gzread (resource $gzo, entier $tai lie) 

La fonction gzread () va lire les donnees situees dans la ressource $gzo en indiquant la 
faille maximale a lire grace au deuxieme parametre $ faille : 



fl^jt GZ_lecture.php 



<?php 

// Ouverture du fichier en mode de lecture 

$gzopen = gzopen ('. /test .gz' , "r") 

or die (' Ouverture du fichier . gz echouee'); 

// lit jusqu'a length octets dans le fichier compresse gzip, 

// represents par zp. La lecture s'arrete lorsque 

//length octets (decompresses) ont ete lus, ou que la 

// fin du fichier a ete atteinte. 

$gzread = gzread ($gzopen, 1024); 

echo $gzread; 

gzclose ($gzopen) ; 
?> 
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Compresser/Decompresser 

Tout aussi simple que l'ecriture et la lecture, la compression et la decompression se font 
chacune en une seule ligne de code. Les fonctions concernees sont gzcompress () pour la 
compression et gzuncompress() pour la decompression. 

chaTne gzcompress(chaTne $donnees[, entier $niveau_compression]) 
chaTne gzuncompress (chaTne $donnees[, entier $taille]) 

La fonction gzcompress() compresse la chaine $donnees selon un taux de compression 
$taux_compression pouvant aller de 1 a 9. 1 est le plus rapide et 9 genere la meilleure 
compression. Pour sa part, gzuncompress () decompresse la chaine $donnees compressee 
via gzcompressO jusqu'a avoir atteint la taille de $taille en octets. 



<^jt GZ_compression.php 



<?php 

$gzopen = gzopen ( ' . /test .gz' , "w") 

or die ( ' Ouverture du fichier .gz echouee' ) ; 

// string gzcompress ( string data [, int level] ) 

// compresse la chaine donnee en utilisant le format de donnees ZLIB. 

$chaine = "Bon jour tout le monde . " ; 

echo ' avant la compression. . .<br/>$chaine = '. $chaine . '<br/xbr/>' ; 

$gzcompress = gzcompress ($chaine) ; 

echo 'apres la compression. . .<br/>$chaine= '. $gzcompress . ' <br/xbr/>' ; 

// string gzuncompress ( string data [, int length] ) 
// decompresse une chaine compressee. 
$gzuncompress = gzuncompress ($gzcompress) ; 

echo 'apres la decompression. . .<br/>$chaine= '. $gzuncompress 
*» . '<br/xbr/>' ; 

gzclose ($gzopen) ; 
?> 

Jouer avec le curseur de position dans le fichier 

Vous pouvez vous promener dans la chaine de donnees grace a la fonction gzseek() ou 
revenir au debut du fichier compresse avec ZLIB au moyen de la fonction gzrewindQ. 

bool gzrewind (resource $gzo) 

entier gzseek(resource $gzo, entier $emplacement) 
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La fonction gzrewind() replace le curseur de position au debut du fichier defini par le 
parametre $gzo. En fait, cela est equivalent a: gzseek($gzopen, 0);. Au contraire, 
gzseek() deplace le pointeur a un endroit precis ($empl acement) du fichier ZLIB defini 
par la ressource $gzo. 

/!\ Positionnement n-1 

Lors du choix de la position, il est indispensable de se rappeler que la position 1 dans le fichier possede 
la valeur pour la fonction gzseek(). Pour rappel, c'est exactement la meme chose pour fseek() en ce 
qui concerne le traitement des fichiers texte. 

int gztell (resource $zp) retourne la position du pointeur de position dans le 
fichier .gz. 

Tout comme pour gzseek(), gztel 1 () retournera la valeur (zero) lorsque le pointeur se 
trouvera a la premiere position dans le fichier .gz. 



^* GZ_curseur.php 








<?php 










$file = 'test 


. g z ' ; 








$gzopen = gzopen ($f ile, " 


r", 0); 






// On lit le 


contenu du fichier gz 


en 


entier 


$gzread = gzread ($gzopen, 


f ilesize 


($f 


Lie) ); 


echo $gzread 


. '<br/>' ; 








// On lit la 


aosition du 


pointeur 


de 


lecture 


$gztell = gzt 


sll ($gzopen) 


; 






echo $gztell 


. '<br/>' ; 








// On revient 


au debut du fichier 






gzrewind ( $gzopen) ; 








$gztell = gzt 


all ($gzopen) 


; 






echo $gztell 


,'<br/>' ; 








// On deplace 


le curseur 


a la 5e p 


osi 


tion 


// ATTENTION: 


la lere position a p 


our 


valeur 


// done la 5e 


position a 


pour valeur 


4 


$gzseek = gzseek ($gzopen, 


4) ; 






$gztell = gzt 


sll ($gzopen) 


; 






echo $gztell 


. '<br/>' ; 
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// On lit de la position actuelle jusqu'a la fin du fichier 
$gzread = gzread ($gzopen, filesize ($file) ) ; 
echo $gzread .'<br/>'; 

gzclose ($gzopen) ; 
?> 



Lecture partielle dans le fichier 

Lors de l'etude de la fonction gzread (), le contenu entier du fichier .gz a ete lu. gzread (), 
grace a son second argument, permet aussi de lire un nombre tres precis de signes dans 
le fichier. Et une fonction tres interessante, nommee gzpassthru(), permet de connaitre 
le contenu restant a lire. 

int gzpassthru(resource $zp) 



^j GZ_finir_lecture.php 








<?php 








$gzopen = gzopen ( ' . /test .gz' , "r") 

or die ( ' Ouverture du fichier .gz echouee' ) ; 








$gzread = gzread ($gzopen, 2 ) ; 

echo ' lecture de 2 caracteres de la chaine = ' 

// affiche: Bo 


. $gzread 


.'<br/>' ; 




$nchar = gzpassthru ($gzopen) ; 








echo '<br/>'. $nchar; 








gzclose ($gzopen) ; 
?> 









Recuperer un fichier formate 

ZLIB permet de compresser des donnees. II ne cherche aucunement a savoir ce que vous 
avez formate. Done, le fichier peut contenir du texte pur, du texte au format HTML ou 
XML ou autre encore. Voici un exemple avec une page Internet ecrite en HTML. 

Les fonctions qui vont etre utilisees dans cet exemple sont les suivantes : 

string gzgetc (resource $zp) retourne une chaine contenant un seul caractere. Cela 
revient a faire gzread($gzopen, 1) ;. L'avantage de gzgetcQ est que cette fonction 
est plus rapide pour lire un seul caractere. 
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string gzgets(resource $zp, int $length) retourne une chaine d'une taille 
maximale n-1, ou la valeur n est affectee a la variable $length. 
string gzgetss (resource $zp, int $length [, string $balises_permises] ) est 
identique a gzgetsQ avec en plus la suppression de toutes les balises HTML et PHP 
du contenu lu dans le fichier .gz. Les variables $bal ises_permises represented les 
balises HTML que gzgetss () doit laisser dans le texte lu. 



#$ GZ_page_HTML.php 



<?php 

// La chaine sur laquelle effectuer les manipulations 

$chaine = "<htmlxheadxtitle>Utilisation ZLIB</titlex/head>" ; 

$chaine .= "<body>On etudie en ce moment <i>l' extension " ; 

echo "<b>ZLIB</b></ix/bodyx/html>" ; 

// Ouverture du fichier test.gz en mode ecriture 
$gzopen = gzopen ( ' . /test .gz' , "w") 

or die (' Ouverture du fichier . gz echouee' ) ; 

// On ecrit la chaine dans le fichier test.gz 
gzwrite ($gzopen, $chaine) ; 

// on detruit la variable $chaine 
unset ($chaine) ; 

gzclose ($gzopen) ; 

$file = 'test.gz'; 

// ouverture du fichier en mode lecture 
$gzopen = gzopen ($file, "r", 0); 

// Lecture du contenu du fichier gz en entier 

$gzread = gzread ($gzopen, filesize ($f ile) ) ; 

echo 'lecture du contenu du fichier avec gzread () 

et htmlentities ().. .<br/>' ; 
echo htmlentities ( $gzread) . '<br/xbr/>' ; 

// Retour du pointeur de lecture au debut du fichier 
gzrewind ( $gzopen) ; 

// Deplacement du curseur a la 4e position 

echo 'Deplacement du curseur a la 5e position, <br/>' ; 

$gzseek = gzseek ($gzopen, 3) ; 
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echo ' et on affiche le caractere qui y est positionne avec 

gzgetc ( ) . . . <br/>' ; 
$gzgetc = gzgetc ($gzopen) ; 
echo $gzgetc . ' <br/xbr/>' ; 

// Retour du pointeur de lecture au debut du fichier 
gzrewind ( $gzopen) ; 

echo 'Affichage du contenu du fichier avec gzgets ().. .<br/>' ; 
$gzgets = gzgets ($gzopen, f ilesize ($f ile) ) ; 
echo $gzgets . ' <br/xbr/>' ; 

// Retour du pointeur de lecture au debut du fichier 
gzrewind ($gzopen) ; 

echo 'Affichage du contenu avec gzgetss ( ) . . . <br/>' ; 
echo ' Seule la balise HTML des caracteres gras 

(<b>) <br/>' ; 
$gzgetss = gzgetss ($gzopen, f ilesize ($f ile) , "<b>"); 
echo $gzgetss; 

gzclose ($gzopen) ; 
?> 

Compression/Decompression : DEFLATE 

DEFLATE est un algorithme de compression/decompression sur les donnees. II obeit a la 
norme RFC 1951. Autrement dit, DEFLATE va compresser des donnees et ces donnees 
compressees seront sauvegardees dans un fichier compresse a l'aide de ZLIB. 

string gzdefl ate (string $data [, int $level]) compresse les donnees. 
string gzinfl ate(string $data [, int $taille]) decompresse les donnees. Le 
second argument, $tai 1 1 e, de la fonction i nf 1 ate() indique le nombre de caracteres 
a decoder. 



&# GZ_deflate_inflate.php 



<?php 

$gzopen = gzopen ( ' . /test .gz' , "w") 

or die ( ' Ouverture du fichier .gz echouee'); 



$chaine = "Bon jour tout le monde . " ; 

echo ' avant encodage . . .<br/>$chaine = '. $chaine . ' <br/xbr/>' ; 
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// string gzdeflate ( string data [, int level] ) 
// compresse la chaine donnee en utilisant 
// le format de donnees DEFLATE. 
$gzdeflate = gzdeflate ($chaine) ; 
echo 'apres encodage . . .<br/>$chaine = '. $gzdeflate .'<br/xbr/>' 

// string gzinflate ( string data [, int length] ) 
// decompresse une chaine compressee avec la methode gzdeflate () 
$gzinflate = gzinflate ($gzdef late) ; 
echo 'apres decodage . . .<br/>$chaine = '. $gzinflate .'<br/xbr/>' 



gzclose ($gzopen) ; 
?> 

1 .4 Cas pratique : gestion des donnees et fichiers 

Les programmeurs experimentes sauvegardent souvent les erreurs generees par 
1' application dans des fichiers texte appeles fichiers de logs. Or, vous avez vu que 
sauvegarder des donnees textuelles dans un fichier compresse permet d' avoir un gain de 
place. Ann de comparer les trois methodes, a savoir textes, fichiers compresses BZIP2 et 
archives ZIP, nous vous presentons en guise de cas pratique un exemple avec un 
formulaire de connexion. Si vous saisissez le bon pseudonyme (login) et le bon mot de 
passe (password), 1' application vous inscrit un message de confirmation a l'ecran 
particulierement delicat. Par contre, si le pseudonyme ou le mot de passe ne valident pas 
votre identite, alors un message d'erreur sera sauvegarde afin que le webmaster puisse en 
prendre connaissance ulterieurement. 

Afin de bien comparer les trois methodes vues precedemment, nous allons effectuer les 
trois types de sauvegarde. L'objectif ici n'est pas de trouver le login et le mot de passe 
mais bien de se tromper une centaine de fois afin de comparer la difference de taille des 
fichiers/archives generes sur le disque dur et savoir quelle methode est la plus econome 
en termes d'espace disque. C'est la raison pour laquelle nous vous avons cache le login 
et le mot de passe dans un autre chapitre du livre afin de vous laisser chercher des 
informations la ou vous n'iriez pas habituellement. 

$^j cas_pratiquel .php 

<html> 
<head> 
<title>Gagnez de l'espace disque</title> 
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</head> 

<body> 

<?php 

if (isset ($_POST['login' ] ) && isset ($_POST [' password' ])) { 

// Les versions non cryptees de $bonlogin et $bonpassword 

// se trouvent quelque part dans le livre 

// les deux sont mis ensemble et dans 

// un petit cadre. Regardez bien 

$bonlogin = ' 3491e6c6121cll030677673a743529c0880c4580' ; 

$bonpassword = ' debal2df 7f 2e9c6b4bbl31f 00ba4e86624d56baf ; 

if (shal ($_POST [' login' ] ) == $bonlogin && 

shal ($_POST ['password' ] ) == $bonpassword) { 

echo ' Tu es trop fort!!!'; 
} else { 

$time = time ( ) ; 

echo $time; 

// On ecrit dans bzip2 

$str = 'plante le '. $time; 

$bzo = bzopen('./bzip2/'. $time . ' .bz2 ' , "w" ) ; 

$bzw = bzwrite ($bzo, $str, strlen ($str) ) ; 

bzclose ($bzo) ; 

// On ecrit dans textes 

$pathname = './textes/'; 

$filename = $time .'.txt'; 

$fp = f open ($pathname . $filename, "w+") ; 

fwrite($fp, $str, strlen ($str) ) ; 

// On ecrit dans une archive ZIP 
$zip = new ZipArchive () ; 

if ( $zip->open ( ' . /erreurs login.zip', ZipArchive: : CREATE) ) { 
$zip->addFile ( $pathname . $filename, $ filename ) ; 
echo ' ok' ; 

} else { 

echo ' echec' ; 

} 

$zip->close ( ) ; 

f close ($fp) ; 

} 
} else { 

echo 'vous devez saisir un login et un mot de passe'; 
} 
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?> 
















<form action^ 


"#" method=' 


POST"> 












login <input 


type="text" 


name=" 


login 


" /><b 


r/> 






password <inp 


ut type="password" 


name 


="password" 


/><b 


r/> 


<input type=' 


submit" name 


="vali 


der" 


value= 


"Vali 


der" 


/> 


</f orm> 
















</body> 
















</html> 

















Trompez-vous une bonne centaine de fois et comparez les differences de taille entre le 
repertoire bz.ip2, le repertoire texte et 1' archive zippee. Attention, la difference est tres 
nette. 

Quant a la surprise, elle est de taille. Et le vainqueur est... le repertoire textes ! Le 
deuxieme est le repertoire bzip2 et le dernier 1' archive ZIP. Pourquoi me 
demanderez-vous ? Simplement parce que la compression, que ce soit en ZIP ou en 
BZIP2, demande des operations algorifhmiques a effectuer et done une plus grande taille 
dans le fichier. Ce qui signifie que pour un grand nombre de fichiers contenant tres peu 
de donnees, les fichiers texte sont les plus legers puisqu'ils ne subissent aucune 
transformation. Voyons maintenant un cas pratique, le meme a vrai dire, sauf que cette 
fois nous allons sauvegarder les messages d'erreurs dans un meme fichier qui aura une 
validite d'une journee. 

Au niveau metier, cette logique est d'ailleurs beaucoup plus facile a gerer pour le 
webmaster qui peut recuperer les erreurs au jour le jour. Voici done le code qui, pour les 
trois methodes, ajoute les messages d'erreurs en fin de fichier et ce, pendant une journee 
complete de 24 heures. 

*^£ cas_pratique2.php 

<html> 
<head> 
<title>Gagnez de la place</title> 

</head> 

<body> 

<?php 

if (isset ($_POST['valider' ] ) && isset ($_POST [' login' ] ) && 

^ isset ($_POST['password' ])) { 

// L' important ici n'est pas de trouver le bon login 

// Mais justement de se tromper deux cents ou trois cents fois 
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// dans une journee et comparer la taille 

$bonlogin = ' 3491e6c6121cll030677673a743529c0880c4580' ; 

$bonpassword = ' debal2df 7f 2e9c6b4bbl31f 00ba4e86624d56baf ; 

if (shal ($_POST[' login' ] ) == $bonlogin && shal ($_POST [' password' ] ) == 
*» $bonpassword) { 

echo ' Tu es trop fort '.'.'.'; 
} else { 

$str = "L' utilisateur a echoue lors de sa tentative de connexion le 
*• ". date("d/m/Y", time()) .'a', date ( "H : i : s", time()) ."\n"; 
$time = date ("Y-m-d", time () ) ; 
echo $time .'<br/>'; 

////// 

// On enregistre avec BZIP2 

$nom fichier = './bzip2/'. $time . '.bz2'; 

// Si le fichier du jour n'existe pas, il est cree, 

// sinon les donnees sont ecrites a la suite des donnees existantes 

$bzo = bzopen($nom fichier, "w"); 

// On ecrit dans bzip2 

$bzw = bzwrite ($bzo, $str, strlen ($str) ) ; 

bzclose ($bzo) ; 

// Fin de BZIP2 

////// 

////// 

// On ecrit dans le fichier texte quotidien 

//$pathname = './textes/'; 

$nom_fichier = './textes/'. $time .'.txt'; 

$fp = fopen ($nom fichier, "a+"); 

fwrite($fp, $str, strlen ($str) ) ; 

// Fin fichiers texte 

////// 

////// 

// On ecrit dans une archive ZIP 

$zip = new ZipArchive () ; 

if ( $zip->open ( ' . /erreurs login.zip', ZipArchive: : CREATE) ) { 

$zip->addFile ( $nom_f ichier, $nom fichier); 

echo ' ouverture archive ZIP --> ok' ; 
} else { 

echo 'ouverture archive ZIP --> echec' ; 
} 
$zip->close ( ) ; 
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// Fin ZIP 
////// 

f close ($fp) ; 

echo ' <br/xbr/>echec de connexion. 

Allez, un peu de courage, vous y etes presque.'; 
} 
} else { 

echo 'vous devez saisir un login et un mot de passe'; 
} 

?> 

<form action="#" method="POST"> 

login <input type="text" name="login" /><br/> 

password <input type="password" name="password" /><br/> 

<input type=" submit" name="valider" value="Valider" /> 

</f orm> 

</body> 
</html> 

Dans ce deuxieme cas pratique, nous decouvrons une limite de BZIP2. II ne permet pas 
d'ajouter des donnees. II ecrase automatiquement le fichier BZIP existant pour en creer 
un nouveau alors que ZIP, recuperant toujours le fichier texte qui se met a jour a chaque 
tentative de connexion echouee, ecrase simplement le fichier texte existant dans son 
archive. II est done tres facile de faire evoluer le script de telle sorte que, au fur et a 
mesure du temps, c'est toujours la meme archive ZIP, mais avec l'ajout de chaque fichier 
texte genere quotidiennement. 

Ces deux cas pratiques peuvent done etre considered comme des tests pour en venir au 
cas pratique definitif qui est cas_pratique3.php. 



J^jt cas_pratique3.php 




<html> 




<head> 




<title>Gagnez de la place</title> 




</head> 




<body> 




<?php 




if(isset($ POST['valider' ] ) && isset($ POST [' login' ] ) 


&& 


*• isset($ POST ['password' ] ) ) { 
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// L' important ici n'est pas de trouver le bon login 

// Mais justement de se tromper deux cents ou trois cents fois 

// dans une journee et comparer la taille 

$bonlogin = ' 3491e6c6121cll030677673a743529c0880c4580' ; 

$bonpassword = ' debal2df 7f 2e9c6b4bbl31f 00ba4e86624d56baf ' ; 

if (shal ($_POST[' login' ] ) == $bonlogin && shal ($_POST [' password' ] ) = 
*♦ $bonpassword) { 

echo ' Tu es trop fort!!!'; 
} else { 

$str = "L' utilisateur a echoue lors de sa tentative de connexion le 
*► ". date("d/m/Y", time()) .'a', date ( "H : i : s", time()) ."\n"; 

////// 

// Ecriture dans le fichier texte quotidien 

// Definir la date du jour 

$aujourd_hui = date ( "Y-m-d" , time ( ) ) ; 

echo "aujourd'hui = ". $aujourd hui .'<br/>'; 

// Definir le fichier quotidien 

$nom fichier = './textes/'. $aujourd hui .'.txt'; 

// S'il s'agit d' une nouvelle journee, 
// creer un nouveau fichier du jour 
if (! file exists ($nom fichier) ) { 

// On definit la date de la veille 
$hier = date ( "Y-m-d", time() - 86400); 
echo 'hier = '. $hier . ' <br/xbr/>' ; 

// Recuperer le fichier de la veille 

$nom fichier hier = './textes/'. $hier .'.txt'; 

// Renommer le fichier de la veille au fichier du jour 

rename ($nom fichier hier, $nom fichier); 

// Ecraser les donnees existantes de la veille 
$fp = fopen($nom fichier, "w+"); 

// Si c'est le fichier deja cree pour la journee, 
// On a j oute les donnees a la suite du fichier 
} else { 

$fp = fopen($nom fichier, "a+"); 

fwrite($fp, $str, strlen ($str ) ) ; 
} 
// Fin fichiers texte 
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// On ecrit dans une archive ZIP 
$zip = new ZipArchive () ; 

if ( $zip->open ( ' . /erreurs login.zip', ZipArchive :: CREATE) ) { 

$zip->addFile ( $nom_f ichier, $nom fichier); 

echo ' ouverture archive ZIP --> ok'; 
} else { 

echo 'ouverture archive ZIP --> echec' ; 
} 

$zip->close ( ) ; 
// Fin ZIP 
////// 

f close ($fp) ; 

echo ' <br/xbr/>echec de connexion. Allez, 

un peu de courage, vous y etes presque.'; 
} 
} else { 

echo 'vous devez saisir un login et un mot de passe'; 
} 

?> 

<form action="#" method="POST"> 

login <input type="text" name="login" /><br/> 

password <input type="password" name="password" /><br/> 

<input type="submit" name="valider" value="Valider" /> 

</form> 

</body> 
</html> 

Avec ce troisieme cas pratique, les seuls fichiers existants seront le fichier texte du jour 
ainsi qu'une seule archive ZIP qui contiendra toutes les donnees. 



1 .5 Check-list 

Dans ce chapitre, nous avons vu : 

• les extensions BZIP2, ZIP et ZLIB ; 

>/ comment creer des fichiers de donnees compressees avec BZIP2 ; 

s/ comment creer des archives avec ZIP ; 
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*/ la totalite des fonctions de ZLIB ; 

>/ comment compresser avec chacune des extensions de ZLIB ; 
«/ comment decompresser avec chacune des extensions de ZLIB ; 
*/ la gestion de fichiers et dossiers compresses. 
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Avez-vous dejd eu besoin d'exporter le contenu d'une 
base de donnees en un fichier Microsoft Excel ? Ou 
OpenOffice.org Calc ? Nous pouvons le faire facilement 
grace a quelques extensions de PHP. 
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2.1 COM : creer des documents Microsoft Office 

COM, c'est l'extension qui va nous permettre de creer des documents Microsoft Office. 
COM signifie Component Object Model et permet a du code ecrit en n'importe quel 
langage d'interagir avec du code ecrit dans un autre langage, a condition que ces deux 
langages respectent les conventions de nommage COM. Ce qui tombe plutot bien, vu que 
PHP et Visual Basic les respectent. . . Nous allons done utiliser COM arm que PHP puisse 
manoeuvrer Visual Basic. 

Meme s'il est preferable de connaitre Visual Basic, vous pourrez vous en sortir sans rien 
savoir de ce langage. 

Decouvrir COM 

Tout d'abord, sachez que COM fait partie du coeur de PHP. II n'y a done rien a faire pour 
pouvoir l'utiliser, si ce n'est s'assurer que le langage avec lequel nous souhaitons faire 
communiquer PHP soit bien installe. Dans notre cas, cela se resume a s'assurer que 
Microsoft Word (si vous voulez generer un document Word) ou Excel (pour un document 
Excel) soit installe sur votre systeme. 

Un fichier Microsoft Word 

Nous allons commencer simplement, en ecrivant une petite phrase dans un document 
Word. Dans un repertoire nomme chap02, creez le fichier com_word.php et remplissez-le 
comme ceci : 



fl^j com_word.php 




<?php 




$repertoire = "D:\dynamisez 


PHP\chap02"; 


?> 





Lorsque nous aurons besoin d'enregistrer notre fichier, nous utiliserons un chemin absolu 
pour indiquer le repertoire hote. 

Les quelques lignes que nous allons rajouter maintenant servent a instancier 
Microsoft Word : 

// Demarrage de Word 
$word = new COM ( "word. application" ) 
or die ( "Impossible de lancer Word"); 
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En fait, l'objet COM que nous venons de creer et de mettre de cote dans la variable $word 
est une instance de 1' application Microsoft Word. C'est done a travers la variable $word 
que nous donnerons des instructions en Visual Basic. Et la premiere chose que nous allons 
faire, c'est de creer un document sur lequel s'appliqueront nos modifications : 

// Cree un document vide 
$word->Documents->Add ( ) ; 

Pour le moment, ne vous preoccupez pas de la syntaxe : nous sommes en train de faire 
du Visual Basic, nous y reviendrons ulterieurement. Voici maintenant la ligne qui va nous 
permettre d'inscrire une phrase dans notre document : 

// ecrit dans le document 
$word->Selection->TypeText ("Hello world !"); 

Nous decidons ensuite que le mot "worl d" soit en gras. II va done nous falloir selectionner 
ce mot : 




Puis le faire passer en gras : 

// Passer la selection en gras 
$word->Selection->Font->Bold=99 99 998; 

II ne nous reste plus qu'a enregistrer notre fichier, en specifiant d'abord le bon chemin 
d'enregistrement : 

// Selectionner un repertoire 
$word->ChangeFileOpenDi rectory ( $repertoire) ; 
// Enregistrer le fichier 
$word->ActiveDocument->SaveAs ("test. doc") ; 

Et n'oublions pas de fermer notre instance de Microsoft Word et de liberer la memoire : 

//Fermeture de Word 
$word->Quit ( ) ; 

// Liberation des ressources 
$word = null; 

Vous pouvez maintenant lancer le fichier comjword.php depuis votre navigateur favori. 
Rien ne s'affichera a l'ecran mais votre fichier a bien ete sauvegarde a l'endroit convenu. 
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Voici le code complet du fichier comjword.php : 

J^j[ com_word.php 

<?php 

$repertoire = "D:\dynamisez PHP\chap02" ; 

// Demarrage de Word 
$word = new COM ( "word. application" ) 
or die ( "Impossible de lancer Word"); 

// Cree un document vide 
$word->Documents->Add ( ) ; 

// ecrit dans le document 
$word->Selection->TypeText ("Hello world !") 

// deplacer le curseur de deux caracteres 
$word->Selection->MoveLef t ( 1 , 2 ) ; 
// Selectionner 5 caracteres 
$word->Selection->MoveLeft (1, 5, 1 ) ; 

// Passer la selection en gras 
$word->Selection->Font->Bold=99 99 998; 

// Selectionner un repertoire 

$word->ChangeFileOpenDirectory ( $repertoire) , 

// Enregistrer le fichier 

$word->ActiveDocument->SaveAs ("test. doc") ; 

//Fermeture de Word 

$word->Quit ( ) ; 

// Liberation des ressources 

$word = null; 

?> 



La documentation de COM 

Maintenant que le premier fichier Microsoft Word a ete cree, attardons-nous un peu sur 
la partie Visual Basic de notre code. En effet, toutes les fonctions que nous avons utilisees 
dans le fichier comjword.php (TypeTextQ, MoveLeft()...) sont des fonctions 
Visual Basic, et non des methodes de l'objet COM. C'est pour cela que la documentation 
de COM ne nous interesse pas. Nous allons maintenant voir comment obtenir du code 
Visual Basic executant les actions que nous souhaitons, et comment le retranscrire au sein 
de notre code PHP. 
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Obtenir du code Visual Basic 

Commencons par ouvrir Microsoft Word, exactement comme si nous allions rediger un 
nouveau document. 

Dans le menu Outils, selectionnez le sous-menu Macro, puis cliquez sur Nouvelle 
Macro... ; une boite de dialogue s'ouvre alors. 

Fig. 2.1 : 

Creer une nouvelle 



Enregistrer une macro 



Norn de la macro : 



nouveauFichier 
Affecter la macro au(x) 



Barres d'outils Clavier 

Enregistrer la macro dans : 



Tous les documents (normal. dot) 
Description : 



Macro enregistree le 16/11/2007 



Donnez-lui un nom explicite, puis cliquez sur 
OK. Une nouvelle petite fenetre apparait a 
Pecran. 



Fig. 2.2 : 

Un enregistreur ? 



Cette petite fenetre ne presente que deux 

boutons dont les symboles sont eloquents : nous sommes visiblement en train 
d'enregistrer quelque chose, mais quoi ? Tout bonnement l'ensemble des modifications 
que nous allons maintenant faire a notre document. 

Nous allons done creer un nouveau document vide en cliquant sur Nouveau, dans le 
menu Fichier. Dans ce nouveau document, ecrivons "Hello world !" puis selectionnons 
le mot "world" a l'aide du clavier (tant que nous sommes en train d'enregistrer notre 
macro, les selections de texte ne peuvent se faire a la souris). Mettons-le en gras, puis 
enregistrons notre document sur notre disque dur. Nous pouvons enfin arreter 
l'enregistrement de la macro en cliquant sur le bouton carre du petit enregistreur. 

Notre macro, e'est-a-dire la suite des instructions Visual Basic permettant de creer un 
nouveau document, d'ecrire "Hello world !" a l'interieur et bien d'autres choses, est 
done enregistree et visible quelque part. Pour la voir, selectionnez le sous-menu Macro 
(dans le menu Outils) et cliquez sur Macros... 



53 



Utiliser la bureautique 







^^^^^B 












Norn de la macro : 






Executer 






nouveauFichier| 










J 

1 


Fermer 
Executer pas a pas 






Modifier 






Creer 






Supprimer 






M 


acros disponibles dans : 






Organiser... 






Normal. dot (modele global) 


zl 








Description : 








1 Macro enregistree le 19/11/2007 















Fig. 2.3 : 

Selectionnez votre 



Dans la boite de dialogue qui apparait, selectionnez votre macro, puis cliquez sur le 
bouton Modifier. L'editeur Visual Basic s'ouvre alors, affichant votre macro. Voici a quoi 
elle ressemble : 

$JW macro nouveauFichier 

Sub nouveauFichier ( ) 

' nouveauFichier Macro 

' Macro enregistree le 16/11/2007 
i 

Documents .Add Template := 

"C:\Documents and SettingsY.ANormal . dot" 

, NewTemplate : =False, DocumentType :=0 
Selection. TypeText Text:="Hello world !" 
Selection . MoveLeft Unit :=wdCharacter, Count: =2 

Selection . MoveLeft Unit :=wdCharacter, Count:=5, Extend: =wdExtend 
Selection . Font . Bold = wdToggle 

ChangeFileOpenDirectory "D:\dynamisez PHP\chap02" 
ActiveDocument . SaveAs FileName: ="Helloworld.doc", FileFormat:= 

wdFormatDocument, LockComments :=False, Password:="", 

*» AddToRecentFiles:= 

True, WritePassword: =" " , ReadOnlyRecommended:=False, 

*» EmbedTrueTypeFonts : = 

False, SaveNativePictureFormat : =False, SaveFormsData: =False, 

SaveAsAOCELetter:=False 
End Sub 
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Comprendre le code Visual Basic et l'interpreter en PHP a travers COM 

Nous pouvons voir, dans la premiere ligne de ce code que Ton demande a un objet de 
1' application, Documents, d'ajouter (via, visiblement, une methode Add()) quelque chose. 
La methode Add() contient plusieurs arguments: Template, NewTemplate et 
DocumentType. Voici comment nous ecrivons cette ligne, dans notre nchier comjword 
.php: 

$word->Documents->Add ( ) ; 

Notre variable $word contient une instance de Microsoft Word. Nous cherchons a 
atteindre l'objet Document de 1' application, c'est pourquoi il y a une fleche (->) entre notre 
variable et l'objet Document. Ce meme objet Document dispose d'une methode Add(), ainsi 
que nous le specifie le code Visual Basic contenu par notre macro, qui nous permet 
d'ajouter un document sur lequel travailler. Comme vous pouvez le voir, nous ne passons, 
en PHP, aucun parametre a la methode Add(). Les noms de ces arguments, apparaissant 
dans le code Visual Basic, nous renseignent sur leur nature : ils ne servent qu'a decrire un 
document Word par defaut. 

Neanmoins, avant d'enlever ses parametres, nous nous sommes assures, en faisant des 
tests avec et sans, que cela marchait. Lorsque vous decouvrirez de nouvelles fonctions, ou 
de nouveaux objets Visual Basic, il vous faudra bien les tester au sein de votre code PHP ! 

(j) Les fonctions en Visual Basic 

Lorsque I'on appelle, en Visual Basic, une methode ou une fonction, nous ne passons pas les 
parametres a cette derniere en utilisant des parentheses. On separe (par un espace) le nom de la 
fonction et ses arguments, et on donne le nom de chaque parametre. Ce sont ces specificites 
syntaxiques qui nous permettent de savoir que I'on a affaire a une fonction et de la traiter comme telle 
depuis PHP. 

Regardons la deuxieme ligne du code Visual Basic : 

Selection. TypeText Text: ="Hello world !" 

Elle nous informe de l'existence d'un objet Selection dans 1' application Word ; et que 
cet objet dispose d'une methode TypeText () qui ne prend qu'un seul argument nomme 
Text. De par le nom de la methode, nous comprenons qu'il s'agit de l'instruction ecrivant 
"Hel 1 o worl d ! " dans notre document. Le parametre a passer est done la chaine a ecrire. 
Voici comment nous l'interpretons en PHP : 

$word->Selection->TypeText ("Hello world ! " ) ; 
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Vous comprenez l'astuce ? Les differences de syntaxe qu'il y a entre PHP et 
Visual Basic ? 

Les constantes : de Visual Basic vers PHP 

L'etape d'apres consiste a selectionner le mot "world". II va done falloir deplacer le 
curseur, qui se trouve a la fin de la chaine "Hello world !", de deux caracteres vers la 
gauche, de maniere a le positionner juste apres le dernier caractere du mot "world". Voici 
1' instruction Visual Basic : 

Selection .MoveLeft Unit : =wdCharacter, Count:=2 

Comme nous le voyons, e'est encore l'objet Selection qui entre en jeu, par le biais d'une 
methode MoveLeft (). Cette methode necessite deux parametres : Unit et Count. Encore 
une fois, e'est le nom de ces parametres et de ces mefhodes qui va nous permettre d'en 
comprendre la nature. 

Ainsi, la methode MoveLeft () laisse clairement entendre, de par son nom, qu'elle va 
deplacer le curseur vers la gauche (et nous en prontons pour deduire qu'il doit exister une 
methode MoveRight()). Le premier argument, Unit, demande clairement quelle va etre 
l'unite etalon, et le second argument, Count, demande de combien d'unites nous allons 
nous deplacer. 

Voici comment nous integrons cela en PHP : 

$word->Selection->MoveLef t ( 1 , 2 ) ; 

Le second parametre, Count, etant un nombre, nous le faisons apparaitre en tant que tel 
en PHP. Le premier parametre, Uni t, en revanche, n'est ni une chaine de caracteres (dans 
le code Visual Basic, le mot wdCharacter n'est pas entre guillemets), ni un nombre. II 
s'agit d'une constante propre a Microsoft Word ; e'est pourquoi nous ne pouvons utiliser 
directement ce nom de constante dans notre code PHP, mais plutot la valeur de cette 
constante. Mais alors, comment connaitre le contenu de la constante wdCharacter ? 

Pour cela, il va nous falloir faire un peu de Visual Basic. Dans l'editeur Visual Basic, 
juste en dessous de notre precedente macro, ecrivons le code Visual Basic suivant : 

&Qt Macro ecritConstante 

Sub ecritConstante ( ) 

Selection. TypeText Text :="wdCharacter " 
Selection . TypeText Text : =wdCharacter 
Selection . TypeParagraph 
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Selection. TypeText Text: 


="wdExtend " 


Selection. TypeText Text: 


=wdExtend 


Selection . TypeParagraph 




Selection. TypeText Text: 


="wdToggle " 


Selection. TypeText Text: 


=wdToggle 


Selection . TypeParagraph 




End Sub 





Cette macro va simplement ecrire dans le document Word courant les noms des 
constantes que nous utilisons dans le fichier comjword.php suivis de leurs contenus. 
Fermez l'editeur Visual Basic (inutile d'effectuer une sauvegarde). Vous pouvez 
maintenant lancer votre nouvelle macro dans Microsoft Word en cliquant sur Macros... 
dans le sous-menu Macro du menu Outils. Selectionnez votre macro dans la boite de 
dialogue qui apparait, puis cliquez sur Executer. Dans votre document Word, il y a 
maintenant trois lignes, et la premiere vous renseigne sur le contenu de la constante 
wdCharacter : celle-ci vaut 1. 

Maintenant que nous avons deplace notre curseur juste derriere le mot "world", nous 
allons le selectionner. Voici ce que nous dit le code Visual Basic : 

Selection .MoveLeft Unit : =wdCharacter, Count:=5, Extend :=wdExtend 

Nous allons encore une fois utiliser la methode MoveLeft () de l'objet Selection mais, 
cette fois, un parametre de plus a fait son apparition : Extend. II est la pour signifier que 
nous allons etendre la selection courante en meme temps que nous deplacons le curseur. 
Comme il s'agit d'une constante, nous executons notre macro ecri tConstante, et nous 
apprenons qu'elle vaut 1. Voici done comment interpreter cette ligne de Visual Basic dans 
notre code PHP : 

$word->Selection->MoveLeft (1, 5, 1 ) ; 
Nous avons selectionne notre mot. Nous allons le passer en gras. En Visual Basic, cela se dit : 

Selection . Font . Bold = wdToggle 

Cette fois, la syntaxe Visual Basic nous indique que nous allons manipuler l'objet Font, 
appartenant lui-meme a l'objet Selection. Cette fois-ci, ce n'est pas un appel a une 
methode que nous allons effectuer. Nous allons simplement changer la valeur de l'attribut 
Bol d. Encore une fois nous allons utiliser une constante done, encore une fois, nous allons 
lancer notre macro ecri tConstante pour apprendre que cette constante vaut 9999998. 
L' interpretation en PHP est la suivante : 

$word->Selection->Font->Bold=99 99 998; 
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Sauvegarder le fichier et liberer les ressources 

II ne nous reste plus qu'a sauvegarder et a liberer les ressources. Voici comment opere le 
code Visual Basic pour la sauvegarde : 

ChangeFileOpenDirectory " D:\dynamisez PHP\chap02" 

ActiveDocument . SaveAs FileName : ="Helloworld . doc" , FileFormat : = 
wdFormatDocument, LockComments :=False, Password:^"" , 
*» AddToRecentFiles:= 

True, WritePassword: =" " , ReadOnlyRecommended:=False, 
*» EmbedTrueTypeFonts : = 

False, SaveNativePictureFormat : =False, SaveFormsData : =False, 
SaveAsAOCELetter:=False 

Tout d'abord, nous assignons un "repertoire courant" grace a la methode 
ChangeFileDi rectory (). Cette methode dispose de plusieurs arguments dont nous 
n'avons nul besoin. C'est pourquoi nous la traduirons ainsi au sein de notre fichier PHP : 

$word->ChangeFileOpenDirectory ( $repertoire ) ; 

La seconde methode, SaveAsQ, est issue de l'objet ActiveDocument. Encore une fois, 
nous n'avons pas besoin de tous ses arguments : 

$word->ActiveDocument->SaveAs ("test. doc") ; 



(J) Ne maltraitez pas les arguments ! 

Dans cette demonstration, nous n'utilisons pas systematiquement tous les arguments d'une methode ou 
fonction. Lorsque vous vous retrouverez face a des fonctions inattendues ou inconnues, prenez le temps 
de tester pour verifier que tout marche bien, avant de supprimer des arguments a priori inutiles I 

Notre fichier etant sauvegarde, nous devons encore fermer notre instance de 
Microsoft Word avant de liberer les ressources : 

//Fermeture de Word 
$word->Quit ( ) ; 

// Liberation des ressources 
$word = null; 

Notre fichier est termine, et nous avons appris a comprendre Visual Basic pour l'utiliser 
avec PHP via COM. Cependant, n'oubliez pas qu'il ne s'agit que d'astuces pour vous 
eviter de l'apprendre. Si d'aventure, vous etes amene a generer des documents plus 
complexes, l'apprentissage de Visual Basic sera necessaire... 
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Exporter des donnees de SQL vers Microsoft Excel 

Avec les connaissances acquises depuis le debut de ce chapitre, vous devriez y arriver 
sans trop d'inconvenients Mais nous allons quand meme vous accompagner encore un 
peu dans l'utilisation de COM, ou plutot dans l'utilisation de Visual Basic en PHP via 
COM. 

Notre base de donnees 

Ce n'est pas la peine de se compliquer la vie. Une seule table avec peu de donnees suffira. 
Nous allons done creer une nouvelle base que nous appellerons "meteo" : 

CREATE DATABASE 'meteo' ; 

Au sein de cette base, creons la table "temperature" : 

CREATE TABLE ' meteo' .' temperature' ( 

' id' INT NOT NULL AUTO_INCREMENT PRIMARY KEY , 

'mois' VARCHAR( 10 ) NOT NULL , 

'temperature' INT NOT NULL 

) 

Remplissons-la ainsi : 



INSERT 


INTO 'meteo' .'temperature' ( 




'id' , 






'mois' 


/ 




' temperature' 




) 

VALUES 


< 




NULL , 


' Janvier' , '0' 




) i \ 

NULL , 


' Fevrier ' , ' -5' 




NULL , 


'Mars', '8' 




1 i \ 

NULL , 


'Avril', '15' 




NULL , 


'Mai', '15' 




) i { 
NULL , 


'Juin', '25' 




NULL , 


'Juillet', '30' 




) r \ 

NULL , 


'Aout', '40' 




), ( 
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Definir le look final de notre fichier Microsoft Excel 

Maintenant que nous avons des donnees stockees et pretes a l'emploi, nous devons definir 
la maniere par laquelle ces donnees seront organisees dans notre fichier Excel. Nous 
allons done utiliser Microsoft Excel pour faire une maquette. Nous en profiterons pour 
enregistrer une nouvelle macro en meme temps que nous realiserons notre maquette. 

Pour ce faire, nous utiliserons la meme technique qu'avec Microsoft Word ! Lancez 
Microsoft Excel puis, immediatement, selectionnez l'option Nouvelle Macro... du 
sous-menu Macro, lui-meme se trouvant dans le menu Outils. Donnez un nom a votre 
macro, et e'est parti. N'oubliez pas d'arreter l'enregistreur, une fois que vous avez fini. 
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Fig. 2.4 : Un tableau et un graphique 
Nous nous proposons, sur ce fichier Excel, de faire apparaitre un tableau et un graphique. 
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Recuperer le code Visual Basic de la maquette 

Une fois votre maquette terminee, recuperez dans l'editeur Visual Basic le code de votre 
macro, et reperez quelles instructions permettent de selectionner une cellule et d' ecrire 
dedans. 

Pour selectionner une cellule, le code Visual Basic de notre macro nous propose ceci : 

Range ("B2") .Select 

Et pour ecrire dans une cellule, le code Visual Basic nous propose cela : 

ActiveCell.FormulaRlCl = "MOIS" 

Maintenant que nous le savons, nous allons ecrire une macro qui mettra en evidence 
chacune des constantes Visual Basic que nous allons utiliser dans PHP : 

Sub constante ( ) 

' constante Macro 

' Macro enregistree le 11/11/2007 par Redfish 



Range ("Al") .Select 

ActiveCell.FormulaRlCl = "xlRight" 
Range ("A2") .Select 
ActiveCell.FormulaRlCl = xlRight 

End Sub 

Cette macro va ecrire "xlRight" dans la cellule Al, et le contenu de la constante xlRight 
dans la cellule A2. II nous faut encore completer cette macro avec toutes les constantes 
que nous allons utiliser pour rediger notre fichier PHP. 

Commencer le fichier PHP 

A present, nous avons tout le materiel pour demarrer la redaction de notre fichier PHP. 
Toujours dans votre repertoire chap02, creez un fichier com_excel.php et remplissez-le 
comme suit : 



J^£ com_excel.php 



<?php 

$conn=mysql_connect ( ' localhost' , ' root' , ' ' ) 
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or die ( ' Probleme lors de la connexion a MYSQL'); 
mysql_select_db ( 'meteo' , $conn) 

or die (' Probleme lors de la selection de la base de donnees'); 
$query="SELECT * FROM 'temperature' "; 
$res=mysql_query ($query) 

or die (' Probleme lors de la reception des enregistrements' ) ; 

$i = 1; 

while ($tableau = mysql_f etch_array ($res) ) { 

$i++; 

echo $tableau ['mois' ] . " :: ". $tableau [' temperature' ]. "<br/>" ; 
} 
?> 

Ce fichier se contente d'aller chercher les donnees dans la base puis de les afficher sur 
notre page web. 

Ouvrir et fermer une instance de l'application Microsoft Excel 

II va nous falloir ouvrir une instance de Microsoft Excel. Copiez ces lignes au tout debut 
de votre fichier com_excel.php : 

$excel=new COM ( "Excel . application" ) 

or die ( "Impossible d'instancier l'application Excel .<br/>" ) ; 

Lorsque nous aurons effectue toutes les operations necessaires, nous devrons fermer 
1' instance de Excel. Pour ce faire, copiez ces lignes a la toute fin de votre fichier : 

$excel->Quit ( ) ; 
$excel = null; 



Travailler sur des feuilles et des classeurs 

Comme vous le savez surement, un fichier Excel est constitue d'un classeur, lui-meme 
constitue d'une ou plusieurs feuilles. Si, lorsque vous avez enregistre votre macro, vous 
avez fait des operations comme la creation d'un nouveau fichier, d'une nouvelle feuille, 
etc., vous pourrez voir les instructions realisant ces actions dans le code Visual Basic de 
votre macro et les utiliser dans PHP. Sinon, voici ce qu'il faut rajouter dans votre fichier 
com_excel.php : 

$excel=new COM ( "Excel . application" ) 

or die ( "Impossible d'instancier l'application Excel .<br/>" ) ; 

$excel->Workbooks->Add ( ) ; //Aj out d'un classeur 
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$book=$excel->Workbooks (1) ; //$book contient le classeur actif 
$sheet=$book->Worksheets (1) ; //$sheet contient la feuille active 
$sheet->Name = "Temperature" ; //Attribution d' un nom a la feuille 

En procedant de cette maniere, le classeur ($book) et la feuille ($sheet) seront toujours 
a portee de main... 

Sauvegarder le fichier 

Comme nous allons tester de nombreuses fois notre fichier au fur et a mesure de sa 
creation, autant ecrire les instructions de sauvegarde et, pourquoi pas, rajouter un petit 
lien pointant vers le fichier Excel que com_excel.php aura cree. Modifiez votre code de 
la maniere suivante : 

$fichier = "D:\dynamisez PHP\chap02\excel.xls"; 

$book->SaveAs ($f ichier ) ; //Enregistrement du document 

$sheet = null; 

$book = null; 

$excel->Workbooks->Close ( ) ; //Fermeture du classeur 

$excel->Quit ( ) ; 

$excel = null; 

echo "Telechargez votre <a href =' excel .xls'>fichier</ a>" ; 

Nous en profitons pour ajouter des lignes liberant les ressources occupees par $sheet et 
$book. 

Realiser l'en-tete du tableau 

Si vous testez votre travail des maintenant, le fichier excel.xls se trouvera bien la ou vous 
le souhaitiez. Maintenant, commencons a le remplir. L'en-tete de notre tableau, seul 
element non dynamique, semble etre un bon choix pour demarrer. Completez done 
com_excel.php ainsi : 



$cell=$sheet->Range ( ' B2' ) ; // selection de la cellule 




$cell->FormulaRlCl="MOIS"; // ecrire dans la cellule 




$cell=$sheet->Range ('B3' ) ; 




$cell->FormulaRlCl=" TEMPERATURE"; 




$i = 1; 




while ($tableau = mysql fetch array ($res) ) { 




$i++; 




echo $tableau [' mois' ] • " :: ". $tableau [' temperature' ] 
} 


."<br/>"; 
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E Microsoft Excel - excel.xls 
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Fig. 2.5 : 

C'est un bon debut ! 



Vous pouvez tester voire travail. Et en profiter pour noter un leger souci : si par hasard 
le fichier excel.xls devait deja exister, votre serveur moulinera sans generer le nouveau 
fichier. Voici done comment eviter ce probleme : 



$f ichier 



"D : \dynamisez PHP\chap02\excel . xls" ; 



if ( f ile_exists ( "excel . xls" ) ) 
unlink ( "excel . xls" ) ; 

$book->SaveAs ( $f ichier ); //Enregistrement du document 



Remplir le tableau avec les donnees de la base 

Comme vous l'avez tres justement devine, c'est dans la boucle whi le de notre code que 
cela va se passer : 




Comme l'adresse de chaque cellule est definie par un couple lettre/nombre, et que nous 
allongeons notre tableau horizontalement, il va nous falloir incrementer la partie "lettre" 
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de ce systeme d'adressage. Pour cela, nous allons utiliser les fonctions ord() et chr(), qui 
permettent de connaitre le code ASCII d'un caractere ou inversement, le caractere lie a 
un code ASCII. 

Comme la toute premiere cellule que nous allons manipuler au sein de la boucle while 
se trouve dans la colonne C, nous allons initialiser notre variable $i a 
ord("B") (c'est-a-dire 66). La premiere instruction de la boucle est d'incrementer $i : le 
reste de la boucle travaillera alors avec le bon contenu de variable. 

Donner du style 

Commencons par l'en-tete. Voici ce que nous indique le code Visual Basic : 



Range ("B2 :B3") .Select 




Selection . ColumnWidth 


= 14.29 


Selection . Font . Bold = 


True 



Et voici son pendant PHP : 

//Style de l'en-tete 

// Selectionner les cellules de l'en-tete 

$cell = $sheet->Range ("B2:B3") ; 

//elargir la selection 

$cell->ColumnWidth = 14.29; 

//passer le texte de la selection en gras 

$cell->Font->Bold = true; 

//aligner le texte de la selection a droite 

$cell->HorizontalAlignment = -4152; 

// mettre le fond de la selection en gris 

$cell->Interior->ColorIndex = 15; 

Ce code est, bien entendu, a ecrire apres que le tableau ait ete rempli, soit juste apres la 
boucle while. 

Nous allons maintenant centrer le contenu de toutes les cellules de notre tableau (sauf 
celles de l'en-tete), et reduire un peu leur largeur : 




II ne vous reste plus qu'a faire apparaitre les cadres : 
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// selectionner 1' ensemble du tableau 

$cell = $sheet->range ('B2: ' . chr ($i) . ' 3' ) ; 

//Appliquer une bordure autour de la selection, 

// sur les 4 cotes 

for($a = 7 ; $a <= 10 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Borders ($a) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = -4138; 
} 

// Mettre des bordures a 1' interieur de la selection 
for($a = 11 ; $a <= 12 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Borders ($a) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = 2; 
} 
$bordure = null ; 
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► Fig. 2.6 : Un magnifique tableau 

Ajouter un graphique 

Eh oui ! Que serait Microsoft Excel sans les graphiques ! Regardons tout de suite dans 
notre macro comment Visual Basic s'y prend : 

Charts. Add 

ActiveChart . ChartType = xlColumnClustered 
ActiveChart . SetSourceData 

Source:=Sheets ("Temperature "). Range ("B2 :N3" ) , PlotBy:= 
xlRows 
ActiveChart .Location Where : =xlLocationAsObject, Name : =" Temperature" 
ActiveSheet . Shapes ( "Graphique 1" ) . IncrementLef t -89.25 
ActiveSheet . Shapes ( "Graphique 1" ) . IncrementTop -113.25 
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ActiveSheet . Shapes ( "Graphique 1" ) . ScaleWidth 1.14, msoFalse, 
msoScaleFromTopLef t 

Et voici comment nous l'interpretons avec PHP : 

//Aj outer un graphique 

$graphique = $book->Charts->Add ( ) ; 

$graphique->ChartType = 51; // histogramme 

//Selection des sources du graphique : 

$sourceGraphique = $sheet->range ( ' B2 : ' . chr ( $i) . ' 3' ) ; 

$graphique->SetSourceData ($sourceGraphique, 1) ; 

$sourceGraphique = null; 

// Definir le graphique comme faisant partie 

// de la feuille "Temperature" 

$graphique->Location (2, "Temperature"); 

// deplacer et dimensionner le graphique 

$forme = $sheet->Shapes ( "Graphique 1"); 

$forme->IncrementLeft (-89.25) ; 

$forme->IncrementTop (-113 .25) ; 

$forme->ScaleWidth (1 .14, 0, 0); 

$forme = null; 

$graphique = null ; 

Votre fichier Excel est d'ores et deja termine, avec son tableau et son graphique ; il est 
pret a l'emploi. 

(j) Pensez d I i be re r la memoire 

Lorsque Ton utilise COM pour creer des documents Microsoft Office, les variables que nous creons pour 
cela - telles que $excel ou Sgraphique - sont tres gourmandes en memoire. N'oubliez done pas de la 
liberer des que vous n'en avez plus besoin en assignant la valeur null ou en utilisant la fonction 
unset (). 

Terminons ce passage sur COM par le code complet du fichier com_excel.php : 

J^£ com_excel.php 

<?php 

$excel=new COM ( "Excel . application" ) 

or die ( "Impossible d'instancier 1' application Excel .<br/>" ) ; 

$excel->Workbooks->Add ( ) ; //Aj out d' un classeur 

$book=$excel->Workbooks (1) ; //$book contient le classeur actif 
$sheet=$book->Worksheets (1 ) ; //$sheet contient la feuille active 
$sheet->Name = "Temperature" ; //Attribution d' un nom a la feuille 
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$conn=mysql connect ( ' localhost' , ' root' , ' ' ) 

or die (' Probleme lors de la connexion a MYSQL'); 

mysql_select_db ( 'meteo' , $conn) 

or die (' Probleme lors de la selection de la base de donnees' ) 

$query="SELECT * FROM 'temperature' " ; 

$res=mysql_query ($query) 

or die (' Probleme lors de la reception des enregistrements' ) ; 

$cell=$sheet->Range ( ' B2' ) ; // selection de la cellule 
$cell->FormulaRlCl="MOIS"; // ecrire dans la cellule 
$cell=$sheet->Range ('B3' ) ; 
$cell->FormulaRlCl=" TEMPERATURE"; 

$i = ord("B") ; 

while ($tableau = mysql_f etch_array ($res) ) { 

$i++; 

echo $tableau [ 'mois' ] . " :: ". $tableau [' temperature' ]. "<br/>" ; 

$cellSelected = chr($i)."2"; 

$cell=$sheet->Range ($cellSelected) ; 

$cell->FormulaRlCl=$tableau ['mois' ] ; 

$cellSelected = chr($i)."3"; 

$cell=$sheet->Range ($cellSelected) ; 

$cell->FormulaRlCl=$tableau [' temperature' ] ; 
} 

//Style de l'en-tete 

// Selectionner les cellules de l'en-tete 

$cell = $sheet->Range ("B2 :B3") ; 

//elargir la selection 

$cell->ColumnWidth = 14.29; 

//passer le texte de la selection en gras 

$cell->Font->Bold = true; 

//aligner le texte de la selection a droite 

$cell->HorizontalAlignment = -4152; 

// mettre le fond de la selection en gris 

$cell->Interior->ColorIndex = 15; 

//centrer les cellules du tableau 

// Selectionner les cellules a centrer 

$cell = $sheet->Range ('C2: ' . chr ($i) .' 3' ) ; 

$cell->HorizontalAlignment = -4108; 

// retrecir la taille (largeur) de la selection 

$cell->ColumnWidth = 8.5; 

// selectionner 1' ensemble du tableau 
$cell = $sheet->range ('B2: ' .chr ($i) . ' 3' ) ; 
//Appliquer une bordure autour de la selection, 
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// sur les 4 cotes 

for($a = 7 ; $a <= 10 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Borders ($a) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = -4138; 
} 

// Mettre des bordures a l'interieur de la selection 
for($a = 11 ; $a <= 12 ; $a++) { 

// Selectionner le bon cote de la cellule 

$bordure = $cell->Borders ($a) ; 

$bordure->LineStyle = 1; 

$bordure->Weight = 2; 
} 
$bordure = null; 

//Aj outer un graphique 

$graphique = $book->Charts->Add ( ) ; 

$graphique->ChartType = 51; // histogramme 

//Selection des sources du graphique : 

$sourceGraphique = $sheet->range ( ' B2 : ' . chr ( $i) . ' 3' ) ; 

$graphique->SetSourceData ($sourceGraphique, 1) ; 

$sourceGraphique = null; 

// Definir le graphique comme faisant partie 

// de la feuille "Temperature" 

$graphique->Location (2, "Temperature"); 

// deplacer et dimensionner le graphique 

$forme = $sheet->Shapes ( "Graphique 1"); 

$f orme->IncrementLef t (-8 9.25) ; 

$f orme->IncrementTop (-113.25) ; 

$forme->ScaleWidth(l .14, 0, 0); 

$forme = null; 

$graphique = null; 

$fichier = "D:\dynamisez PHP\chap02\excel.xls"; 

if (f ile_exists ("excel . xls" ) ) 
unlink ( "excel . xls" ) ; 

$book->SaveAs ($f ichier ) ; //Enregistrement du document 

$sheet = null; 

$book = null; 

$excel->Workbooks->Close ( ) ; //Fermeture du classeur 

$excel->Quit ( ) ; 

$excel = null; 

echo "Telechargez votre <a href =' excel .xls'>fichier</ a>" ; 

?> 
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2.2 DOM : de XML a OpenOffice.org (OOo) 

Nous allons maintenant voir comment generer des documents OpenOffice.org. Pour cela, 
nous allons utiliser l'extension DOM, qui permet de creer et manipuler des documents 
XML avec PHP, et l'extension ZIP. Mais quel rapport y a-t-il entre ces extensions et les 
fichiers OOo ? Eh bien, un fichier OOo, c'est tout simplement un ensemble de fichiers 
XML compresses en une archive... 

DOM et XML 

DOM (Document Object Model) est une extension de PHP qui nous permet de manipuler 
des fichiers XML. Le but de ce passage n'est pas d'apprendre a utiliser DOM ou XML, 
mais comme nous en aurons besoin pour arranger quelques fichiers, autant faire le tour 
de quelques fonctions importantes. 

(£) XML et PHP k 

DOM ne fonctionne, pour le moment, qu'avec PHP5. Si vous ne disposez que de PHP4, vous pouvez 
utiliser en lieu et place l'extension DOM XML. 

Eventuellement, vous pouvez aussi utiliser l'extension SimpleXML pour manipuler des fichiers XML. 
Comme son nom I'indique, SimpleXML est tres simple d'utilisation mais, en contrepartie, ne permet pas 
autant de choses que DOM. 

Commencons done, dans notre repertoire chap02, par creer le fichier dom._test.xml : 



<^£ dom_test. 



xml 



<?xml version=" 1 . 0" encoding="utf-8"?> 
<animaux> 

<famille nom="oiseau"> 
<poule> 

La poule domestique (Gallus gallus domesticus) 
est un oiseau de l'ordre des gall i formes . 
</poule> 
<pigeon> 

Les pigeons (genre Columba) sont des oiseaux de 
la famille des Columbidae . 
</pigeon> 
</f amille> 
<famille nom="poisson"> 
<hareng> 

Le hareng (Clupea harengus) est un poisson vivant 
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en grands bancs . 
</hareng> 
</famille> 
</animaux> 

Ouvrir un fichier XML et recuperer le noeud racine 

Toujours dans le repertoire chap02, creez un fichier nomme domjtest.php et remplissez-le 
comme suit : 

^^ dom_test.php 

<?php 

$dom = new DomDocument ( ) ; 

$dom->load ( ' dom test.xml'); 

// Recuperer la racine 

$animaux = $dom->f irstChild; 

echo "<b>noeud racine : </b>" . $animaux->tagName; 

echo "<br/>"; 

?> 

L'objet DomDocument est l'objet de base. II represente un document XML dans son 
integralite. C'est d'ailleurs a partir de cet objet que nous chargeons notre fichier XML, via 
la methode DomDocument: :load(). 

Pour recuperer le nceud racine de notre document, nous allons utiliser la propriete 
firstChild de l'objet DomDocument. Cette propriete renvoie le premier nceud enfant sous 
la forme d'un objet DomNode. 

Dans notre exemple, la variable $animaux contient l'integralite du nceud <animaux>, 
enfants compris. 

Cet objet DomNode dispose d'une propriete tagName qui renvoie, sous la forme d'une 
chaine de caracteres, le nom de notre balise. 

Obtenir une liste de noeuds grace au nom des balises 

L'extension DOM nous permet de faire une recherche de nceuds dans l'integralite d'un 
document, et ce a partir d'un nom de balise. Completez done le fichier dom_test.php par 
le code suivant : 

// Obtenir une liste de noeuds par leur nom 
$listeFamille = $dom->getElementsByTagName ( ' f amille' ) ; 
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Nous utilisons la variable $dom, c'est-a-dire l'objet DomDocument contenant l'integralite de 
notre document XML, afin de faire une recherche dans l'ensemble du document, sans 
s'occuper de la hierarchie des elements. 

La methode DomDocument: :getEl ementsByTagName() recherche dans tout le document les 
noeuds dont le nom de balise est "f ami lie". Elle renvoie le resultat sous la forme d'un 
objet DomNodeList. 

/j\ Une liste n'est pas un tableau 

L'objet DomNodeList n'est pas un tableau. II est hors de question d'acceder au contenu de cette objet par 
une syntaxe a crochets, done I Pour ce faire, utilisez plutot la methode DomNodeList: :index() ... 

Vous souhaitez connaitre le nombre de resultats renvoyes par la recherche ? 

// Savoir combien il y a de noeuds dans une liste 

echo "noeud racine a <b>" . $listeFamille->length. "</b> noeuds enfants"; 

II nous suffit d'utiliser la propriete length de l'objet DomNodeList. 

Nous allons maintenant passer en revue les noeuds contenus dans $1 i steFami 1 1 e arm d'y 
appliquer un traitement. Nous utilisons a cet effet la structure foreach, bien que d'autres 
solutions soient possibles : 

// Passer en revue les noeuds d' une liste 

echo "<ol>"; 

foreach ($listeFamille as $famille) { 

// obtenir la valeur d'un attribut 

echo "<lixu>" . $f amille->getAttribute (' nom' ) . "</uxbr/>" ; 
} 
echo "</ol>"; 
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Un bon debut 
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Vous pouvez noter l'usage de la methode DomNode: :getAttribute() qui nous permet de 
recuperer, sous la forme d'une chaine de caracteres, le contenu d'un des attributs du 
noeud, en 1' occurrence, le nom de la famille. 

Passer en revue les enfants d'un noeud 

Nous allons maintenant verifier la presence (ou non) d'eventuels enfants au sein de 
chaque famille, puis les lister. Modifions notre code ainsi : 

f oreach ($listeFamille as $famille) { 
// obtenir la valeur d'un attribut 
echo "<lixu>" . $f amille->getAttribute (' nom' ) . "</uxbr/>" ; 

// Verifier si chaque famille dispose d'enfants 
if ( !$famille->hasChildNodes () ) { 

echo "Cette famille n'a pas d' enf ants<br/>" ; 
} else { 

// futurs traitements 
} 
} 

La methode DomNode: :hasChi ldNodes(), comme son nom l'indique, renvoie un booleen 
permettant de savoir si notre nceud dispose d'enfants. 

Continuons sur notre lancee et appliquons un traitement aux eventuels enfants de chaque 
famille. Completez le bloc else de la maniere suivante : 

else { 

// recuperer le premier noeud enfant 
$animal = $f amille->f irstChild; 

//Passer en revue les noeuds d'une liste 
//sans en connaitre les noms 
echo "<ul>"; 
while ($animal) { 

// verifie qu'il s'agit bien d'un DOMElement 
if ( $animal->nodeType == 1) { 

echo "<lixb>" . $animal->tagName . "</bxbr/>" ; 

echo utf8 decode ($animal->f irstChild->nodeValue ) ; 
} 

// avancer au noeud suivant 
$animal = $animal->nextSibling; 
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echo "</ul>"; 



} 



La premiere chose a faire est de recuperer le premier enfant d'une famille. A ce titre, nous 
utilisons la propriete firstChild de l'objet DomNode. 

(j) Methodes homonymes 

Nous avons deja utilise la propriete f i rstChi 1 d, mais avec l'objet DomDocument. Faites attention de bien 
savoir quel objet vous etes en train de manipuler, car si les objets DomDocument et DomNode disposent de 
proprietes et de methodes homonymes, elles ne renvoient pas forcement les memes choses I 

Ensuite, nous verifions le type du noeud auquel nous avons affaire, en utilisant la propriete 
nodeType de l'objet DomNode. En effet, nous ne cherchons a avoir affaire qu'avec des 
nceuds elements, quand un noeud peut etre un attribut ou du texte. 

Si notre noeud est bien du type voulu, nous affichons son nom de balise qui, dans notre 
exemple, represente aussi le nom de l'animal, grace a la propriete tagName. 

Nous allons aussi afficher le petit texte contenu par ce noeud. Pour cela, nous devons 
d'abord atteindre le premier enfant de notre noeud. En effet, le texte est considere comme 
etant un noeud texte. Ensuite, la propriete nodeVal ue renvoie le contenu de notre noeud 
texte sous forme de chaine de caracteres. 

Enfin, nous passons d'un noeud a l'autre grace a la propriete nextSibl ing. Cette derniere 
renvoie le noeud suivant, ou null s'il n'y en a pas. 



Fichier Edition Affichage Historique Marque-pages Outils 
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° nonle 

La poule domestique (Gallus gallus domesticus) est un oiseau de l'ordre des galliformes. 
° pigeon 

Les pigeons (genre Columba) sont des oiseaux de la famille des Columbidae. 
2. poisson 

o hareng 

Le hareng (Clupea harengus) est un poisson vivant en grands bancs. 



Fig. 2.8 : Tout est affiche. 
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Voici le code complet du fichier domjtest.php : 

<^j dom_test.php 

<?php 

$dom = new DomDocument ( ) ; 

$dom->load ( ' dom_test . xml' ) ; 

// Recuperer la racine 

$animaux = $dom->f irstChild; 

echo "<b>noeud racine : </b>" . $animaux->tagName; 

echo "<br/>"; 

// Obtenir une liste de noeuds par leur nom 
$listeFamille = $dom->getElementsByTagName (' famille' ) ; 

// Savoir combien il y a de noeuds dans une liste 

echo "noeud racine a <b>" . $listeFamille->length. "</b> noeuds enfants"; 

echo "<br/>"; 

// Passer en revue les noeuds d' une liste 

echo "<ol>"; 

f oreach ($listeFamille as $ f amille ) { 

// obtenir la valeur d' un attribut 

echo "<lixu>" . $f amille->getAttribute (' nom' ) . "</uxbr/>"; 

// Verifier si chaque famille dispose d'enfants 
if ( !$famille->hasChildNodes () ) { 

echo "Cette famille n'a pas d' enf ants<br/>" ; 
} else { 

// recuperer le premier noeud enfant 
$animal = $famille->f irstChild; 

//Passer en revue les noeuds d' une liste 
//sans en connaitre les noms 
echo "<ul>"; 
while ($animal) { 

// verifie qu'il s'agit bien d' un DOMElement 
if ( $animal->nodeType == 1) { 

echo "<lixb>" . $animal->tagName . "</bxbr/>" ; 

echo utf8 decode ($animal->f irstChild->nodeValue ) ; 
} 

// avancer au noeud suivant 

$animal = $animal->nextSibling; 
} 
echo "</ul>"; 
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} 
} 
echo "</ol>"; 

?> 



Aj outer un noeud 

Avec DOM, lorsque vous souhaitez ajouter un noeud a un document XML, il vous faut 
d'abord le creer. Demarrons un nouveau fichier PHP que nous appellerons dom_ajouter 
.php, et remplissons-le de la maniere suivante : 

^* dom_ajouter.php 

<?php 

$dom = new DomDocument ( ) ; 

$dom->load ( ' dom test.xml'); 

// creer le noeud sans 1' ajouter a l'arbre XML 
$nouvelleFamille = $dom->createElement ( "f amille" ) ; 

// creer un attribut "nom" a ce noeud 
// et lui attribuer une valeur 

$nouvelleFamille->setAt tribute ( "nom" , "reptile") 
?> 

L'objet DomDocument dispose de la methode DomDocument: :createElement(), qui permet 
de creer, en memoire seulement, un nouveau nceud. Dans notre exemple, nous creons un 
nouveau nceud "f ami 1 1 e". 

La methode DomElement: :setAttribute() ajoute un attribut a l'element. Le premier 
parametre de cette methode indique le nom de 1' attribut, et le second indique la valeur de 
cet attribut. 

Le nceud que nous venons de creer ressemble a cela : 

<famille nom="reptile" /> 

Pour le moment, notre nceud ne dispose pas d'enfants. Corrigeons cela. Rajoutez, a la fin 
de dom_ajouter.php, le code suivant : 



//creer le nouveau noeud "animal" 






$nouvelAnimal = $dom->createElement ("serpent" ) ; 






$desc = "Les serpents (sous-ordre des Serpentes) 


K 




"sont des reptiles au corps cylindrique " . 
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et allonge, depourvus de membres apparents." . 

lis partagent cette derniere caracteristique" . 

avec un groupe de vertebres " . 
tetrapodes : les gymnophiones, qui appartiennent" . 

au groupe des lissamphibiens."; 

//creer le DOMText de description 
$description = $dom->createTextNode ($desc) ; 

// a j outer le noeud texte au noeud $nouvelAnimal 
$nouvelAnimal->appendChild ( $description) ; 

// a j outer le noeud $nouvelAnimal 
// au noeud $nouvelleFamille 
$nouvelleFamille->appendChild ($nouvelAnimal) ; 

Nous faisons appel a deux nouvelles methodes. Tout d'abord la methode 
DomDocument: :createTextNode() qui, comme son nom l'indique, va creer un nouveau 
noeud de type texte. Ce nouveau noeud n'est encore relie a rien, et surtout pas a notre 
document. 

La seconde methode, DomElement: :appendChi ld(), permet enfin de Her un noeud a un 
autre. Dans notre exemple, le noeud $nouvel Animal devient un enfant du noeud 
$nouvel leFamil le. Voici a quoi ressemble maintenant le noeud $nouvel leFamil le : 

<famille nom="reptile"> 
<serpent> 

Les serpents (sous-ordre des Serpentes) ... 
...au groupe des lissamphibiens. 
</serpent> 
</famille> 

Passons maintenant a la derniere etape : lier notre nouveau noeud a notre document. Pour 
ce faire, nous allons utiliser encore une fois la methode DomElement: :appendChi ld(), 
mais nous allons l'appliquer depuis le noeud de notre document que nous souhaitons voir 
completer. Ainsi, dans notre exemple, nous creons un noeud "f ami lie" qui doit s'ajouter 
a la suite des autres noeuds "f ami 1 1 e" de notre document. Ces noeuds sont des enfants du 
noeud racine, "animaux". Nous allons done commencer par isoler le noeud racine, puis lui 
ajouter un nouvel enfant. Voici done les quelques lignes a rajouter a dom_ajouter.php : 

// Recuperer la racine 
$animaux = $dom->f irstChild; 

// ajouter le noeud $nouvelleFamille 
// au noeud $animaux 
$animaux->appendChild ( $nouvelleFamille ) ; 
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// on n' oublie pas de sauvegarder notre document modifie : 
$dom->save ( ' dom test . xml' ) ; 

Et voila ! N'oubliez pas d'utiliser la methode DomDocument: :save() pour sauvegarder vos 
modifications dans le fichier dom test.xml. 



<^D - ' ^ http://localhost/dynamisez%20PHP/chap02/dom_test.php 



noeiul l a< me animaux 
noeud raciric a '■> noeud? infants 



1. oiseau 



° puule 

La pouie domestique (Gailus g^dluy domesticus) est un oiseau de lordre des galiitormes 
° pigeon 

Les pigeons (genre Columba) soni des oiseaux de la famille des Columbidae. 

2. poisson 

° hareng 

Le hareng (Clupea harengus) est an poisson vivant en gi'ands bancs 

3. reptile 

° serpent 

Les serpents (sous-ordre des Serpentes) sont des reptiles an soros cylindrique et allonge, depourvus de 
vertebres tetrapodes : les gymnophiones, qui appartiennent an groupe Pes iissstmphibiens. 



Fig. 2.9 : Un noeud de plus 

Vous pourrez voir les modifications en ouvrant le fichier domjtest.php avec votre 
navigateur prefere. 

Effacer un noeud 

Nous venons de creer un nouveau noeud "fami l le". A present, nous allons l'effacer. Pour 
ce faire, creez un nouveau fichier, dom_effacer.php, et remplissez-le comme suit : 

Off, dom_effacer.php 

<?php 

//ouvrir le fichier content. xml 
$dom = new DomDocument ( ) ; 
$dom->load ( ' dom_test . xml' ) ; 
$animaux = $dom->f irstChild; 

// obtenir la liste des noeuds "famille" 
$listeFamille = $dom->getElementsByTagName (' famille' ) ; 

// isoler le noeud "reptile" 
$reptile = null; 
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f oreach ($listeFamille as $f ami lie) { 
if ( $f amille->getAttribute ( ' nom' ) = 
$reptile = $famille; 
break; 



' reptile' ) { 



} 



} 



// effacer le noeud $reptile 
$animaux->removeChild ( $reptile) ; 

$dom->save ( ' dom test.xml'); 
?> 

II n'y a rien de bien complique : on commence par isoler dans une variable le noeud que 
Ton souhaite supprimer, ainsi que son noeud parent. Ensuite, grace a la methode 
DomNode: :removeChild(), on le supprime purement et simplement. 

XML et OOo 

Le fichier OOo Writer que nous allons creer ensemble va presenter les informations 
contenues dans le fichier domjtest.xml. Comme nous l'avons deja fait pour creer des 
documents Microsoft Office, nous allons partir d'une maquette. 

Ouvrez OOo Writer et faites une maquette. 



•frttt Lisbon Affchage- Insertion I want la^leou I'jdtils itnetre AkSc 



i ■■-■■■■;;■ 




■111- ■ II ■ ■ -JJ' 



-is ■ ■■* ■ ■& 



tburipliciiAiiinicJl 



I ^-.^Hf^ii":"iA:"iiTi,il 



Famittt 



b~artiiiJt\ 




Fig. 2.10 : Notre maquette OOo Writer 
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Enregistrez votre maquette sous le nom famille.odt, dans votre repertoire chap02. 

Vous allez maintenant ouvrir ce fichier avec un logiciel de type Winrar ou 7-Zip, et en 
extraire le contenu. 



D 



D 



mimeirvpe 
Fichier 

1 Ko 



j--) styles. xrni 

*>- " Document XML 

^= 9 Ko 



Fig. 2.11 : 

Le contenu de I'archive 
famille.odt 



Comme vous pouvez le constater, nous n'avons ici que des documents XML. 
Rassurez-vous, nous n' allons pas tous les modifier. Nous nous contenterons de manipuler 
le fichier content.xml. Vous pouvez done copier ce fichier dans votre repertoire chap02, 
et effacer tous les autres. 

Ouvrez maintenant content.xml. Voici comment se presente son architecture : 

<^£ content.xml 

<of f ice : document-content> 

<office:scripts/> 

<of f ice : f ont-f ace-decls> 
</of f ice: f ont-f ace-decls> 

<of f ice : automat ic-styles> 
</office: automat ic-styles> 

<of f ice :body> 

<of f ice : text> 

<of f ice: forms/> 

<text : sequence-decls> 
</text : sequence-decls> 

<text :px/text :p> 
<text :px/text :p> 
<text :px/text :p> 

</of f ice : text> 
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</of f ice : body> 
</of f ice : document-content> 

L'espace de noms 

Dans ce fichier, la premiere chose que Ton remarque, ce sont les noms des balises. 

En effet, les noms de balises sont composes de deux mots separes par le signe ":". Le 
premier mot represente ce que Ton appelle l'espace de noms. Ce mot lie chacune des 
balises avec une definition xmlns (toutes ces definitions sont ecrites sous la forme 
d'attributs du noeud racine). 

Le second mot represente tout simplement le nom de la balise. 

C'est une specificite qu'il nous faudra prendre en compte lorsque nous modifierons ce 
fichier. Ainsi, lorsque nous souhaitons creer un nouveau noeud, nous n'utiliserons pas la 
methode DomDocument: :createElement() , mais la methode DomDocument: : create 
ElementNS(). Voici un exemple : 

$nouveauNoeudNS = $dom->createElementNS (' text' , 'p'); 
//cree un noeud 
//<text:p /> 

Le premier argument de la methode indique l'espace de noms, et le second indique le nom. 

Creer un fichier OOo Writer avec DOM et PHP 

Toujours dans notre fichier content. xrnl, nous allons tenter de reperer ou a ete place le 
contenu. Vous l'avez trouve ? 



<text 


P 


text 


style-name="Pl">Famille</text:p> 




<text 


P 


text 


style-name="P3">nomAnimal</text :p> 




<text 


P 


text 


style-name="P2">DescriptionAnimal</text :p> 




<text 


P 


text 


style-name="P4"> </text :p> 




<text 


P 


text 


style-name="P3">nomAnimal</text :p> 




<text 


P 


text 


style-name="P2">DescriptionAnimal</text :p> 




<text 


P 


text 


style-name="Standard"/> 




<text 


P 


text 


style-name="Pl">Famille</text :p> 





II s'agit des balises "p" appartenant a l'espace de noms "text". Notez que chacune des ces 
balises contient un attribut "text : style-name". Cet attribut indique le style du texte, 
c'est-a-dire sa police de caracteres, son alignement, etc. 

Nous allons, dans un nouveau fichier PHP, commencer par effacer toutes ces balises, puis 
les remplacer par de nouvelles, contenant les informations de domjtest.xml. 
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Effacer les vieilles balises 

Toujours dans votre repertoire chap02, creez le fichier ooojwriter.php, et remplissez-le de 
la maniere suivante : 



<^ ooo_writer.php 



<?php 

//ouvrir le fichier content. xml 
$dom = new DomDocument ( ) ; 
$dom->load ( ' content . xml' ) ; 

$racine = $dom->f irstChild; 

// l'espace de nom "text" 

$ns = "urn : oasis : names : tc : opendocument : xmlns : text : 1 . " ; 

// recuperer la liste des noeuds appartenant au 
// name systeme $ns et dont le nom du tag est "p" 
$listeTextp = $dom->getElementsByTagNameNS ($ns, 'p'); 

// recuperer la liste des noeuds dont 

// le nom du tag est "text" (<of f ice : text>) 

$li = $dom->getElementsByTagName ( ' text' ) ; 

$off = null; // contiendra le seul noeud de ce type 

foreach ($li as $1) { 

$off = $1; 
} 

// effacer les anciens noeuds <text:p> 
while ($listeTextp->length > 0){ 

$of f->removeChild($listeTextp->item(0) ) ; 
} 
?> 

Vous remarquez que nous creons une variable $ns contenant une drole d'adresse... II 
s'agit de l'espace de nom "text", que nous avons recupere dans notre fichier content.xml 
(l'espace de nom est indique sous la forme d'un attribut dans le noeud racine). 

Comme vous le voyez, il n'y a rien de bien complique, si ce n'est que nous utilisons la 
methode DomDocument: :getElementsByTagNameNS(), au lieu de la methode DomDocument 
: :getElementsByTagName(), qui fonctionne exactement de la meme maniere que la 
methode DomDocument: :createElementNS(). Vous pouvez neanmoins retrouver vos 
noeuds sans faire de recherche incluant l'espace de noms ; seulement avec le nom de 
balise. C'est d'ailleurs ce que nous faisons pour retrouver la balise <office:text> (mais 
nous vous le deconseillons). 
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Aj outer les nouvelles balises 

Cela ne devrait pas vous sembler si difficile. Voici comment proceder (rajoutez ce code 
a la fin de ooo_writer.php) : 

// ouvrir le fichier dom test.xml 
OdoraSource = new DomDocument ( ) ; 
$domSource->load ( ' dom test . xml' ) ; 

//recuperer la liste des families 

$listeFamille = $domSource->getElementsByTagName (' famille' ) ; 

//chaque famille doit etre traitee : 
f oreach ($listeFamille as $1) { 

// ajouter un noeud pour le "titre" de cette famille 

// dans le document content. xml 

$titreFamille = $l->getAttribute (' nom' ) ; 

$nouveauNoeud = $dom->createElementNS ($ns, 'p', $titreFamille) ; 

// en se referant a content. xml, on attribue le style PI 

$nouveauNoeud->setAttributeNS ($ns, 'style-name', 'PI'); 

$of f->appendChild ( $nouveauNoeud) ; 

// recuperer le premier noeud enfant de cette famille 
$animal = $l->f irstChild; 

// traiter tous les noeuds de cette famille 
$noeudAnimal = null; 
while ($animal) { 

// verifie qu'il s'agit bien d' un DOMElement 
if ( $animal->nodeType == 1){ 

// Creer le noeud pour le nom de 1' animal 

$nomAnimal = $animal->tagName; 

$noeudAnimal = $dom->createElementNS ( $ns , 'p', $nomAnimal); 

// en se referant a content. xml, on attribue le style P3 

$noeudAnimal->setAttributeNS ( $ns, 'style-name', 'P3'); 

$of f->appendChild ( $noeudAnimal) ; 

// Creer le noeud pour la description 

$description = $animal->f irstChild->nodeValue; 

$noeudAnimal = $dom->createElementNS ($ns, 'p', $description) ; 

// en se referant a content. xml, on attribue le style P2 

$noeudAnimal->setAttributeNS ( $ns, 'style-name', 'P2'); 

$of f->appendChild ( $noeudAnimal) ; 

// Creer le noeud " " entre chaque animal 

$noeudAnimal = $dom->createElementNS ($ns, 'p', ' '); 

// en se referant a content. xml, on attribue le style P4 
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$noeudAnimal->setAttributeNS ($ns, 'style-name', 'P4'); 
$of f->appendChild ($noeudAnimal ) ; 
} 

$animal = $animal->nextSibling; 



} 



if ( $noeudAnimal != null) { 

$of f->removeChild ( $noeudAnimal) ; 
} 

// aj outer un noeud pour sauter une ligne 
$nouveauNoeud = $dom->createElementNS ($ns, 'p'); 
$nouveauNoeud->setAttributeNS ($ns, 'style-name', 'Standard'); 
$of f->appendChild ( $nouveauNoeud) ; 



$dom->save ( ' content . xml' ) ; 

II n'y a rien de sorcier, n'est-ce pas ? Nous attirons tout de meme votre attention sur un 
point : 

$noeudAnimal = $dom->createElementNS ($ns, 'p', $nomAnimal) ; 

Un troisieme argument a ete ajoute a la methode. En fait, cela revient a faire : 

$noeudAnimal = $dom->createElementNS ($ns, 'p'); 
$noeudTexteAnimal = $dom->createTextNode ($nomAnimal) ; 
$noeudAnimal->appendChild ($noeudTexteAnimal) ; 

Ajouter le fichier content.xml a l'archive famille.odt 

Maintenant que nous avons refait le fichier content.xml a notre convenance, il ne nous 
reste plus qu'une seule chose a faire : mettre ce fichier dans 1' archive famille.odt, qui 
n'est autre que notre fichier OOo. 

II vous faut ajouter ce code a la fin de votre fichier ooojwriter.php : 



//Sauvegarder en un fichier OOo : 




$odt = new ZipArchive; 




if ($odt->open (' famille.odt' , ZIPARCHIVE :: CREATE) = 


== TRUE) { 


// Ajouter (remplacer) le fichier content.xml 




$odt->addFile ( ' content . xml' , ' content . xml' ) ; 




$odt->close ( ) ; 




echo "ok"; 
} 
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Pour plus de details sur la compression, n 'hesitez pas a vous referer au chapitre 

Compresser c'est gagner... 



mmmmmm 



■i-hier Edition Affi chase jrisprtion Kir mat Tableau Outils Feneb-e Aide 






y [Ft 



Times Mew Roman 






A - *> - ^ • 



- 



La poule domestique (Gallus gallus domesticus) est un oiseau de Pordre des galliforrnes 

pigeon 
Les pigeons (genre Columba) sent des oiseaux de lafamille des Columbidae 

ptrtsxou 

hareno* 
Le hareng (Clupsa harengus) est un poisson vivant en grands bancs 



100% IN5 5TD 



Fig. 2.12: Etvoici le resultat final 
Pour conclure ce chapitre, voici le code complet de ooo_writer.php 

^^ ooo_writer.php 

<?php 

//ouvrir le fichier content. xml 
$dom = new DomDocument ( ) ; 
$dom->load ( ' content . xml' ) ; 

$racine = $dom->f irstChild; 

// l'espace de nom "text" 

$ns = "urn : oasis : names : tc : opendocument : xmlns : text : 1 . 0" ; 

// recuperer la liste des noeuds appartenant au 
// name systeme $ns et dont le nom du tag est "p" 
$listeTextp = $dom->getElementsByTagNameNS ($ns, 'p'); 

// recuperer la liste des noeuds dont 

// le nom du tag est "text" (<of f ice : text>) 






I 
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$li = $dom->getElementsByTagName ( ' text' ) ; 

$off = null; // contiendra le seul noeud de ce type 

foreach ($li as $1) { 

$off = $1; 
} 

// ef facer les anciens noeuds <text:p> 
while ($listeTextp->length > 0){ 

$of f->removeChild ( $listeTextp->item ( 0) ) ; 
} 

// on peut commencer a creer de nouveaux noeuds 

// ouvrir le fichier dom test.xml 
$domSource = new DomDocument ( ) ; 
$domSource->load ( ' dom test.xml' ) ; 

//recuperer la liste des families 

$listeFamille = $domSource->getElementsByTagName (' f ami lie' ) ; 

//chaque famille doit etre traitee : 
foreach ($listeFamille as $1) { 

// aj outer un noeud pour le "titre" de cette famille 

// dans le document content. xml 

$titreFamille = $l->getAttribute ( ' nom' ) ; 

$nouveauNoeud = $dom->createElementNS ($ns, 'p', $titreFamille) ; 

$nouveauNoeud->setAttributeNS ($ns, 'style-name', 'PI'); 

$of f->appendChild ( $nouveauNoeud) ; 

// recuperer le premier noeud enfant de cette famille 
$animal = $l->f irstChild; 

// traiter tous les noeuds de cette famille 
$noeudAnimal = null; 
while ($animal) { 

// verifie qu'il s'agit bien d' un DOMElement 
if ( $animal->nodeType == 1){ 

// Creer le noeud pour le nom de 1' animal 

$nomAnimal = $animal->tagName ; 

$noeudAnimal = $dom->createElementNS ($ns, 'p', $nomAnimal) ; 

$noeudAnimal->setAttributeNS ($ns, 'style-name', 'P3'); 

$of f->appendChild ($noeudAnimal ) ; 

// Creer le noeud pour la description 
$description = $animal->f irstChild->nodeValue; 
$noeudAnimal = $dom->createElementNS ($ns, 'p', $description) 
$noeudAnimal->setAttributeNS ($ns, 'style-name', 'P2'); 
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$of f->appendChild ( $noeudAnimal) ; 

// Creer le noeud " " entre chaque animal 

$noeudAnimal = $dom->createElementNS ($ns, 'p', ' '); 

$noeudAnimal->setAttributeNS ($ns, 'style-name', 'P4'); 
$of f->appendChild ($noeudAnimal) ; 
} 

$animal = $animal->nextSibling; 
} 

if ( $noeudAnimal != null) { 

$of f->removeChild ( $noeudAnimal) ; 
} 

// ajouter un noeud pour sauter une ligne 
$nouveauNoeud = $dom->createElementNS ($ns, 'p'); 
$nouveauNoeud->setAttributeNS ($ns, 'style-name', 'Standard') 
$of f->appendChild ( $nouveauNoeud) ; 

} 

$dom->save ( ' content . xml' ) ; 

//Sauvegarder en un fichier OOo : 
$odt = new ZipArchive; 

if ($odt->open (' famille.odt' , ZIPARCHIVE ::CREATE) === TRUE) { 

// Ajouter (remplacer) le fichier content. xml 
$odt->addFile ( ' content . xml' , ' content . xml' ) ; 
$odt->close ( ) ; 
echo "ok"; 

} 
?> 



2.3 Check-list 

Voici la fin de ce long chapitre consacre a la bureautique. Nous avons vu comment 

>/ creer un fichier Microsoft Office en utilisant COM ; 

*/ creer une maquette et sa macro ; 

^ comprendre le code Visual Basic d'une macro et l'interpreter dans PHP ; 

V utiliser DOM ; 

<S creer un document OpenOffice.org. 
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3.4 Check-list 145 



Manipuler 
es images 




PHP ne se limite pas a la generation de pages HTML. 
Dans ce chapitre, nous allons voir comment il est 
possible de generer dynamiquement des images dans les 
formats les plus courants sur le Web, d'en creer a partir 
d'images dejd existantes, ou d'en creer a partir de rien... 
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3.1 GD2 : En toute simplicity 

Nous commencons notre exploration du monde de 1' image facon PHP par GD2, une 
extension qui vous permettra de realiser simplement et rapidement la plupart des taches 
a effectuer sur des images, comme les reduire ou y ecrire une adresse URL. 

Creer une image dynamiquement 

Ann d'aborder simplement GD2, nous allons commencer par voir comment on appelle 
une image deja existante. Creez dans votre editeur favori un nouveau fichier : 
dynamisez_php/chap03/gd.php. A cote de ce fichier, creez un dossier images. Placez une 
image dans ce dossier puis, dans votre fichier gd.php, entrez le code suivant : 



*# gd.php 














<?php 














header ( "Content-type 


: image/jpeg" 


>; 








$im = @imagecreatefr 


omjpeg ("image 


s/cie 


12.jpg" 


) 


or die ( "impossible 


de 


creer un 


fl 


jx 


GD2") ; 




// remplacez "ciel2. 


jpg" 


par le nom 


de 


votre 


image 


imagejpeg ($im) ; 














imagedestroy ($im) ; 














?> 















Lorsque vous ouvrez la page gd.php depuis votre navigateur prefere, votre image apparait 
a l'ecran. Vous pouvez l'enregistrer sur votre disque dur, comme n'importe quelle image 
affichee dans une page web. Vous pouvez aussi faire appel a cette image depuis du code 
HTML. Creez, dans le meme repertoire que votre fichier gd.php, un fichier html_gd.html 
contenant le code suivant : 

^ html_gd.html 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 
*» "http://www.w3.org/TR/html4/strict.dtd"> 
<html> 
<head> 

<meta http-equiv="Content-Type" 
content="text/html; charset=iso-8859-l" /> 
<title>Image GD2</title> 
</head> 
<body> 

<img alt="image dynamique avec GD2" src="gd.php" /> 



SO 
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</body> 
</html> 

Lancez le fichier html_gd.html avec votre navigateur : l'image apparait comme telle, alors 
que l'attribut src de la balise img pointe vers un fichier PHP. 

Observons notre code PHP instruction par instruction, afin de decouvrir les rouages de 
base de GD2 : 

header ( "Content-type : image/ jpeg" ) ; 

Cette premiere instruction sert a renseigner l'en-tete de notre fichier gdphp une fois qu'il 
aura ete genere. C'est grace a cet en-tete que votre navigateur interpretera le fichier 
genere comme etant une image. II est necessaire de placer cette instruction avant toute 
autre instruction d'ecriture. 

Q) Les en-tetes Content-type compatibles avec GD2 

Avec GD2, vous pouvez generer autre chose que des imagesJPEG. Remplacez done I'argument de la 
fonction header() en fonction du type d'image que vous souhaitez obtenir : 

header ( "Content-type : image/ jpeg" ) ; // en-tete JPEG 

header ( "Content-type : image/gif " ) ; // en-tete GIF 

header ( "Content-type : image/png"); // en-tete PNG 

header ( "Content-type : image/wbmp" ) ; // en-tete WBMP (attention : la 



*» plupart des navigateurs ne reconnaissent pas les types WBMP) 






Une fois l'en-tete correctement place, nous chargeons notre image en memoire : 


$im = imagecreatef romjpeg ( "images/ciel2 . jpg" ) ; 



La fonction imagecreatefromjpg() va chercher l'image JPEG de notre choix. Cette 
fonction renvoie un objet de type image que nous stockons dans une variable pour une 
utilisation ulterieure. 

Q) Les autres types d'images 

L'extension GD2 permet de charger d'autres types que leJPEG. Utilisez I'une de ces fonctions selon vos 
besoins : 

// creer la ressource depuis une image GIF. : 
$im = imagecreatef romgif ( "images/ciel2 . gif" ) ; 
// creer la ressource depuis une image PNG : 
$im = imagecreatef rompng ( "images/ciel2 . png 
// creer la ressource depuis une image WBMP : 
$im = imagecreatef romwbmp ( "images/ciel2 .wbmp" ) ; 
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Maintenant que notre image est chargee, il nous faut l'afficher : 

imagejpeg ($im) ; 

II s'agit d'une instruction d'ecriture, c'est-a-dire que c'est ce qui va etre ecrit dans le 
fichier genere par PHP. II faut done imperativement que vous ayez specifie l'en-tete de 
votre image (fonction header ()) avant cette instruction. 

(J) Les autres types d'images 

Comme nous pouvons charger differents types d'images, GD2 nous permet aussi de creer des images 
de differents types : : : 




La toute derniere instruction concerne la destruction de l'image $im : 

imagedestroy ($im) ; 

Cette instruction permet de liberer la memoire utilisee par notre image. En contrepartie, 
nous ne pourrons plus la modifier. 

Fig. 3.1 : 

L'image ciel2.jpg telle 
qu'affichee avec le 
fichier html_gd.html 



3 Image GD2 - Mozilla Firefox 



Fichier Edition Affichage HstOfique Mgrque-pages Outils 



<^ - - - i^ ,_, http:^localhost/dynamisez%20PHP;chap03;html_gd,html 
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Convertir une image 

Voici comment convertir ses images le plus simplement du monde grace a GD2. Modiflez 
votre fichier gd.php comme suit : 



<*$ gd.php 




<?php 




// nous allons renvoyer une image GIF : 




header ( "Content-type : image/gif") ; 




// nous creons notre ressource a partir d'une 


image JPEG : 


$im = Simagecreatef romjpeg ( "images/ciel2 . jpg") 




or die ( "impossible de creer un flux GD2"); 




// nous creons une image GIF : 




imagegif ( $im) ; 




imagedestroy ($im) ; 




?> 





La fonction imagegif () convertit automatiquement notre image de type JPEG en une 
image de type GIF. II en va naturellement de meme pour les autres fonctions. Quel que 
soit le type de notre image, imagejpeg() creera toujours une image JPEG, 
imagepngO une image PNG, etc. 

La seule regie a respecter est 1' adequation entre la fonction header () et la fonction 
d'ecriture. 

Sauvegarder une image creee dynamiquement 

La sauvegarde d'images se fait, comme la conversion, grace aux fonctions d'ecriture 
(imagejpegO, imagegif (), imagepng ()...). Nous allons modifier a nouveau notre fichier 
gd.php : 



*Sfr gd.php 




<?php 




header ( "Content-type : image/ jpeg" ) ; 




$im = @imagecreatef romjpeg ( "images/ciel2 . jpg" ) 




or die ( "impossible de creer un flux GD2"); 




imagejpeg ($im, "images/ciel2 copie.jpg"); 




imagedestroy ($im) ; 




?> 
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La seule difference est l'ajout d'un argument a la fonction imagejpeg() (ou a n'importe 
quelle autre fonction d'ecriture) : une chaine de caractere indique 1' emplacement et le 
nom de 1' image a sauvegarder. 

Lorsque nous lancons dans notre navigateur le fichier html_gd.html, rien ne s'affiche si ce 
n'est le contenu de l'attribut al t de notre balise img. Par contre, le fichier ciel2_copie.jpg 
a bien ete cree dans le repertoire images. En effet, lorsqu'elles ne disposent que d'un seul 
argument, les fonctions d'ecriture ecrivent dans le fichier genere par PHP (dans notre cas, 
1' image est ecrite dans gd.php). Si ces fonctions d'ecriture disposent de deux arguments, 
le flux d'ecriture n'est pas dirige vers le fichier genere, mais vers le fichier image a creer. 

Si nous voulons que notre image soit creee a la fois sur le disque dur et a la fois dans le 
fichier genere, nous avons besoin d'ecrire deux flux dans notre code ; soit deux fonctions 
d'ecriture : 



*fct gd-php 








<?php 








header ( "Content-type : image/ jpeg" ) ; 
$im = Simagecreatef romjpeg ( " images/cie 
or die ( "impossible de creer un flux 


12.jpg") 
GD2") ; 


// creer 1' image 
imagejpeg ($im) ; 


dans 


le fichier genere 


// creer 1' image 
imagejpeg ($im, " 


sur 
Lmage 


le disque dur 
s/ciel2 copie.jpg 


") ; 


imagedestroy ($im 


; 






?> 









Bien entendu, il est possible de creer l'image du fichier genere dans un certain type, et 
de la sauvegarder sur le disque dans un autre. 

3.2 Effectuer des transformations d'images 

Vous voulez pouvoir redimensionner une image ? La faire tourner ? Creer une mosai'que ? 
Voici comment proceder en toute simplicite. 
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Redimensionner une image : creation de vignettes 

Nous allons realiser ensemble un script PHP qui realise une copie d'une image en 
reduisant sa taille. Cela peut etre tres utile si Ton veut programmer une galerie avec un 
sy steme de vignettes. 

Commencons done par creer un nouveau fichier (dans le repertoire chap03) que Ton va 
nommer gd_vignette.php et qui va contenir le code suivant : 

&Q gd_vignette.php 

<?php 

function makeVignette ($grandelmage, $vignette, 

$vignetteLargeurMax, $vignetteHauteurMax) { 

} 

makeVignette ("images/ciel2 . jpg" , "vignettes/ciel2 . jpg", 50, 50); 
?> 

Comme vous pouvez le voir, nous allons programmer cela sous la forme d'une fonction 
qui sera reutilisable a tout moment. Cette fonction dispose de quatre arguments : le 
premier indique la ou se trouve 1' image originale, et le deuxieme ou sauver notre vignette. 
Les troisieme et quatrieme arguments fixent la largeur et la hauteur maximales de la 
vignette. Dans notre exemple, les images originales seront stockees dans un repertoire 
images, et les vignettes dans un repertoire vignettes. 

Nous pouvons d'ores et deja recuperer les dimensions de l'image originale et creer l'objet 
image : 



*^£ gd_vignette.php 



<?php 

function makeVignette ($grandelmage, $vignette, 

$vignetteLargeurMax, $vignetteHauteurMax) { 

$imOriginale = Simagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

$inf oOriginale = getimagesize ($grandelmage) ; 

} 

makeVignette ("images/ciel2 . jpg" , "vignettes/ciel2 . jpg" , 50, 50); 
?> 
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La fonction getimagesi ze() permet de recuperer des informations sur une image et de les 
stacker dans un tableau. L'indice de ce tableau contient la largeur de l'image, et 
l'indice 1 contient la hauteur de l'image. 

Ces informations vont nous permettre de determiner precisement quelles vont etre les 
dimensions de notre vignette, de maniere a ne pas deformer l'image : 



^Jt gd_vignette.php 



<?php 

function makeVignette ($grandelmage, 

$vignette, 

$vignetteLargeurMax, 

$vignetteHauteurMax) { 

$imOriginale = @imagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

$infoOriginale = getimagesize ($grandelmage) ; 

$largeurVignette; 
$hauteurVignette ; 

if ($infoOriginale[0] >= $inf oOriginale [1] ) { 
$largeurVignette = $vignetteLargeurMax; 

$hauteurVignette = ($vignetteLargeurMax/$inf oOriginale [0] ) 
*$infoOriginale[l] ; 
} else { 

$hauteurVignette = $vignetteHauteurMax; 

$largeurVignette = ( $vignetteHauteurMax/$inf oOriginale [ 1 ] ) 
*$infoOriginale[0] ; 
} 

$im = @imagecreatetruecolor ( $largeurVignette , 

$hauteurVignette) 
or die ( "impossible de creer un flux d' image GD2 . " ) ; 

} 

makeVignette ("images/ciel2 . jpg", "vignettes/ciel2 . jpg" , 50, 50); 
?> 

La fonction imagecreatetruecolor() permet de creer un objet image qui contient une 
image vide ayant le premier argument ($largeurVignette, dans notre exemple) pour 
largeur, et le second argument ($hauteurVignette, dans notre exemple) pour hauteur. 
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II ne nous reste plus qu'a creer la vignette sur le disque : 

$^jt gd_vignette.php 

<?php 

function makeVignette ($grandelmage, 

$vignette, 

$vignetteLargeurMax, 

$vignetteHauteurMax) { 

$imOriginale = Simagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 vignette.") 

$inf oOriginale = getimagesize ($grandelmage) ; 

$largeurVignette; 
$hauteurVignette ; 

if ( $inf oOriginale [ ] >= $inf oOriginale [1] ) { 
$largeurVignette = $vignetteLargeurMax; 

$hauteurVignette = ($vignetteLargeurMax/$inf oOriginale [0] ) 
*$infoOriginale[l] ; 
} else { 

$hauteurVignette = $vignetteHauteurMax; 

$largeurVignette = ( $vignetteHauteurMax/$inf oOriginale [ 1 ] ) 
*$infoOriginale[0] ; 
} 

$imVignette = @imagecreatetruecolor ($largeurVignette, 

$hauteurVignette) 
or die ( "impossible de creer un flux d' image GD2."); 

if ( ! imagecopyresized ($imVignette, 

$imOriginale, 

0, 0, 0, 0, 

$largeurVignette, 

$hauteurVignette, 

$infoOriginale [0] , 

$inf oOriginale [1] ) ) { 
return false; 
} 

imagejpeg ($imVignette, $vignette) ; 

return true; 
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if ( ImakeVignette 


"images/ciel2 . 


jpg'V 








"vi 


gnettes/cie 


I2.jpg", 








50, 


50) ) { 






echo 


"Erreur : 


la 


vignette n 


' a pas ete 


creee" ; 


} else 


{ 










echo 
} 
?> 


"la vignette 


a bien ete 


creee" ; 















Notre fonction makeVignette() est a present operationnelle : la fonction 
imagecopyresized()redimensionne l'image contenue par l'objet image $imOriginale et 
la copie dans l'objet image $imVignette. Enfin, la fonction i mage j peg ()sauvegarde notre 
vignette sur le disque. 

Voici la definition de la fonction imagecopyresized() : 

imagecopyresizec 

Redimensionne l'image src_image et la copie dans l'image dst_image. Vous pouvez 
choisir de ne copier et/ou redimensionner qu'une partie de l'image, et la positionner 
n'importe ou dans l'image de destination. 

Syntaxe bool imagecopyresized (resource dst_image, resource 

src_image, int dst_x, int dst_y, int src_x, int src_y, int 
dst_w, int dst_h, int src_w, int src_h) 

L'image de destination. 

L'image source. 

Abscisse du coin superieur gauche de l'image copiee par rapport a 
l'image de destination. 

Idem, mais avec l'ordonnee. 

Designe, dans l'image source, l'abscisse du point representant le 
coin superieur gauche de l'image a copier : nous ne sommes pas 
forces de copier l'integralite de l'image source. 

src_y Idem, mais avec l'ordonnee. 

dstjt La largeur de notre copie, sur son image de destination. 

dst_h La hauteur de notre copie, sur son image de destination. 

srcj La largeur du morceau d' image que nous souhaitons copier, sur 

l'image source. 
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src_h Idem, mais avec la hauteur. 

Notre fonction makeVignette() est certes operationnelle, mais elle est limitee. Nous ne 
pouvons l'appliquer que sur des images de type JPEG. Afin de passer outre, nous allons 
devoir determiner quel est le type de l'image originale avant de creer l'objet image qui 
s'y rapporte. Puis, nous allons faire en sorte que le type de la vignette soit donne par son 
nom (argument $vignette de la fonction). 

II s'avere que la fonction getimagesize(), que nous utilisons deja dans notre code, 
renvoie aussi le type de l'image dans le tableau, index 2, sous la forme d'un entier. Nous 
allons done utiliser cette possibilite dans notre code : 



<^jt gd_vignette.php 



<?php 

function makeVignette ( $grandelmage, $vignette, $vignetteLargeurMax, 

$vignetteHauteurMax) { 



$infoOriginale = getimagesize ($grandelmage) ; 

$imageOriginale; 

switch ( $infoOriginale [2 ] ) { 
case 1 : 

$imOriginale = @imagecreatef romgif ( $grandelmage) 

or die ( "impossible de creer un flux d' image GD2 vignette."); 
break; 
case 2 : 

$imOriginale = @imagecreatef romjpeg ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 vignette."); 
break; 
case 3 : 

$imOriginale = @imagecreatef rompng ( $grandelmage) 

or die ( "impossible de creer un flux d' image GD2 vignette."); 
break; 
case 15 : 

$imOriginale = @imagecreatef romwbmp ($grandelmage) 

or die ( "impossible de creer un flux d' image GD2 vignette."); 
break; 
default : 

return false; 
} 

$largeurVignette ; 
$hauteurVignette ; 
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if ( $inf oOriginale [ ] >= $inf oOriginale [1] ) { 
$largeurVignette = $vignetteLargeurMax; 

$hauteurVignette = ($vignetteLargeurMax/$inf oOriginale [0] ) 
*$inf oOriginale [1 ] ; 
} else { 

$hauteurVignette = $vignetteHauteurMax; 

$largeurVignette = ($vignetteHauteurMax/$inf oOriginale [1] ) 
*$inf oOriginale [0 ] ; 
} 

$imVignette = @imagecreatetruecolor ($largeurVignette, 
** $hauteurVignette) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

if ( ! imagecopyresized ($imVignette, $imOriginale, 0, 0, 0, 0, 

$largeurVignette, $hauteurVignette, 
$inf oOriginale [0] , $inf oOriginale [1 ] ) ) { 
return false; 

} 

switch (strrchr ($ vignette, " . " ) ) { 
case " . jpg" : 

imagejpeg ($imVignette, $vignette) ; 

break; 
case " . jpeg" : 

imagejpeg ($imVignette, $vignette) ; 

break; 
case " . gif " : 

imagegif ($imVignette, $vignette) ; 

break; 
case " .png" : 

imagepng ($imVignette, $vignette) ; 

break; 
case " . wbmp" : 

imagewbmp ( $imVignette, $vignette) ; 

break; 
default : 

return false; 
} 

return true; 
} 

if ( ImakeVignette ( "images/ciel2 . jpg" , 

"vignettes/ciel2 . jpg" , 
50, 50)){ 
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echo 


"Erreur : la vignette n' a pas ete creee"; 


} else 


{ 


echo 


"la vignette a bien ete creee<br/>" ; 


echo 


"<img alt='grosse image' src=' images/ciel2 . jpg' />"; 


echo 
} 
?> 


"<img alt='petite image' src=' vignettes/ciel2 . jpg' />" ; 





Mozilla Firefox 




► Fig. 3.2 : 

L'image d'origine et, 
juste a cote, son alter 
ego "vignette" 



Voici les differentes valeurs que peut prendre l'index 2 du tableau renvoye par la fonction 
getimagesize(): 

1=GIF 

2 =JPEG 

3 = PNG 

4 = SWF 

5 = PSD 

6 = BMP 

7 = TIFF (Intel byte order) 
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8 = TIFF (Motorola byte order) 

9 = JPC 

10 = JP2 

11 = JPX 

12 = JB2 

13 = SWC 

14 = IFF 

15 = WBMP 

16 = XBM 

Ecrire et superposer une image sur une autre 

Vous avez besoin d'incruster un logo sur une image, puis d'y ecrire quelque chose, tout 
cela grace a PHPet GD2 ? Rien de plus simple. Voyons d'abord comment incruster un 
logo (ou quoi que ce soit) sur une image. 

Nous allons pour ce faire creer une nouvelle fonction. Toujours dans le repertoire chap03, 
creez un fichier gd_incrustation.php, ainsi qu'un repertoire incrustations. 

Ouvrez gd_incrustation.php avec votre editeur favori et entrez le code suivant : 



^* gdjncrustation.php 



<?php 

function incrustelmage ($image, 

$imageFini, 
$logoLargeurMax, 
$logoHauteurMax) { 



} 
?> 



Cette fonction prend en compte quatre arguments : le premier indiquera l'adresse de 
l'image originale, le deuxieme l'endroit ou nous voulons stacker l'image une fois traitee, 
le quatrieme et le cinquieme indiqueront la taille maximale du logo sur l'image. Comme 
nous considerons qu'il n'y a qu'un seul logo, l'adresse de celui-ci sera code directement 
dans la fonction. 

Commencons par creer les images dont nous aurons besoin : 

$info!mage = getimagesize ($image) ; 
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$imOriginale = Simagecreatef romjpeg ($image) 

or die ( "impossible de creer un flux d' image GD2"); 

// utilisez 1' image de votre choix : 
$adresseLogo = "images/redf ish.gif " ; 

$imLogo = dimagecreatef romgif ($adresseLogo) 

or die ( "impossible de creer un flux d' image GD2 . " ) ; 

$infoLogo = getimagesize ($adresseLogo) ; 

Vous remarquerez que nous recuperons des informations sur ces images grace a la 
fonction getimagesize(). Cela nous permet, dans un premier temps, de gerer le 
redimensionnement du logo grace au petit algorithme que nous avions vu lorsque nous 
reduisions des images en vignettes. Ajoutons done le code suivant a notre fonction : 



$largeurLogo; 




$hauteurLogo; 




if ($inf oLogo [0 ] 


>= $infoLogo[l] ) { 


$largeurLogo 


= $logoLargeurMax; 


$hauteurLogo 


= ($logoLargeurMax/$inf oLogo [0] ) *$inf oLogo [1 ] ; 


} else { 




$hauteurLogo 


= $logoHauteurMax; 


$largeurLogo 
} 


= ($logoHauteurMax/$infoLogo [1] ) *$infoLogo [0] ; 



II ne nous reste plus qu'a realiser l'incrustation en elle-meme : 

if ( ! imagecopyresized ($imOriginale, 

$imLogo, 

10, 10, 0, 0, 

$largeurLogo, 

$hauteurLogo, 

$inf oLogo [0] , 

$infoLogo[l] ) ) { 
return false; 
} 

imagegif ( $imOriginale, $imageFini) ; 

return true; 

Nous utilisons encore une fois la fonction imagecopyresized(). Vu le nombre 
d' arguments de cette fonction, il est possible d'operer toutes sortes d'agrandissements et 
de copies. 
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Nous souhaitons maintenant ecrire une petite phrase (par exemple l'adresse d'un site 
web) sur notre image, en meme temps que nous y incrustons le logo. Nous allons done 
continuer a ajouter du code dans notre fonction, apres l'instruction pour l'incrustation et 
avant l'instruction d'ecriture sur le disque (fonction imagegif ()) : 



// la coul 


eur du texte : 








$couleur = 


image col or allocate 


( $imOriginale, 








220 


, 30, 0); 


// la phrase a ecrire : 








$phrase = 


"Une magnifique 


pet 


ite 


phrase ! " ; 


// la posi 


tion en x de la 


phrase 


ecrite : 


// la posi 


tion en Y de la 


phrase 


ecrite : 


$positionX 


= 10; 








$positionY 


= $inf olmage [ 1] 


-20 


; 




$tailleDuTexte == 5 ; 








imagestrin 


j ( $imOriginale, 
$tailleDuTexte 
$positionX, 
$positionY, 
$phrase, 
$couleur) ; 


t 







La fonction imagecol oral 1 ocate() nous permet de definir la couleur que nous utiliserons 
pour notre phrase. Les trois derniers arguments de cette fonction representent les trois 
composantes (rouge, vert et bleu) de la couleur. 

Enfin, la fonction imagestring() ecrit notre phrase sur notre image. L'argument 
$tail leDuTexte doit etre compris entre 1 et 5. 

Voici a present le code complet du fichier gd_incrustation.php : 



*# gd_ 


incrustation. php 


<?php 




function 


incrustelmage ($image, 




$imageFini, 




$logoLargeurMax, 




$logoHauteurMax) { 


$infoI 


mage = getimagesize ($image) ; 


$imOri 


ginale = Simagecreatef romjpeg ($image) 


or c 


ie ( "impossible de creer un flux 




d' image GD2 vignette, jpg"); 
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$adresseLogo = "images/redf ish.gif " ; 

$imLogo = @imagecreatef romgif ($adresseLogo) 
or die ( "impossible de creer un flux 
d' image GD2 . ") ; 

$infoLogo = getimagesize ($adresseLogo) ; 

$largeurLogo; 
$ hauteur Logo; 

if ($inf oLogo [0 ] >= $inf oLogo [1 ] ) { 
$largeurLogo = $logoLargeurMax; 
$hauteurLogo = ($logoLargeurMax/$inf oLogo [0] ) 
*$inf oLogo [1 ] ; 
} else { 

$hauteurLogo = $logoHauteurMax; 
$largeurLogo = ($logoHauteurMax/$inf oLogo [1] ) 
*$infoLogo [0] ; 
} 

if ( ! imagecopyresized ($imOriginale, $imLogo, 10, 10, 0, 0, 

$largeurLogo, $hauteurLogo, $inf oLogo [0] , 
$infoLogo[l] ) ) { 
return false; 

} 

// la couleur du texte : 

$couleur = imagecolorallocate ($imOriginale, 220, 30, 0); 
// la phrase a ecrire : 

$phrase = "Une magnifique petite phrase !"; 
// la position en x de la phrase ecrite : 
$positionX = 10; 

// la position en Y de la phrase ecrite : 
$positionY = $inf olmage [ 1 ] -20 ; 
$tailleDuTexte = 5; 

imagestring ($imOriginale, $tailleDuTexte, $positionX, 
$positionY, $phrase, $couleur) ; 

imagegif ( $imOriginale, $imageFini) ; 

return true; 
} 

if ( ! incrustelmage ( " images /gui tare -jpg", "incrustations/guitare.gif", 
150, 150) ) { 
echo "Erreur : la vignette n' a pas ete creee"; 
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} else { 

echo "la vignette a bien ete creee</br>" ; 

echo "<img alt=incrustation' src= incrustations/guitare. gif />" ; 
} 
?> 



vJMozULa Firefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 



■Q | D hl=l=p://lQcalhQ5l=/dynami5ez%20PHP/chap03/gdJncru5l=aUQn,php 



la vignette a bien ete creee 




Fig. 3.3 : 

Notre incrustation 



Dessiner sur une image 

GD2 est fourni avec tout ce qu'il faut pour dessiner. Imaginons que vous ayez besoin, par 
exemple, de generer un graphique sous forme d'image. Nous allons done creer pas a pas 
un script PHP qui construira un histogramme representant un nombre indefmi 
d'enregistrements. 

Commencez par creer, dans votre repertoire chap03, un fichier appele graphique _data 
.php: 

fl^jt graphique_data.php 

<?php 

$graphique_data = array ( 

' titre' => "mon super graphique", 
'configuration' => array ( 
'unite' => "cm", 
'maximum' => 100 
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), 




' enregistrements' => array ( 


array ( 




' nom' => 


"Un", 


' valeur ' 


=> 5 


) r 

array ( 




' nom' => 


"Deux", 


' valeur' 


=> 10 


) r 

array ( 




' nom' => 


"Trois", 


' valeur' 


=> 2 


) i 

array ( 




' nom' => 


"Quatre", 


' valeur' 


=> 35 


) r 

array ( 




' nom' => 


"Cinq", 


' valeur' 


=> 55 


I r 

array ( 




' nom' => 


"Six", 


' valeur' 
) 


=> 8 


) 

); 
?> 





II n'est compose que d'un tableau contenant les donnees du graphique. Nous pourrons 
ajouter ou enlever des enregistrements a notre gre. 

Creez maintenant le fichier graphique. php (toujours dans le repertoire chap03) et 
remplissez-le ainsi : 

<^jt graphique. php 

<?php 

header ( "Content-type : image/png") ; 

// importe le tableau : 

require once (' graphique data. php'); 

$largeur = 800; 
$hauteur = 600; 
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// information sur le repere : 
$repere = array ( 

'origine' => array ( 
' x' => 50, 
' y' => $hauteur-75 
) , 

'maxY' => 5, 
'maxX' => $largeur-20 

); 

$repere [ ' longueurAbscisse' ] = $repere [' origine' ] ['y'] 

-$repere [ ' maxY' ] ; 
$repere [ ' longueurOrdonnee' ] = $repere [' maxX' ] 

-$repere [' origine' ] [' x' '_ 

II creer une image a palette : 

$image = imagecreate ($largeur, $hauteur) ; 

// donner un fond a 1' image : 

$blanc = imagecolorallocate ($image, 255, 255, 255); 

imagefill ($image, 0, 0, $blanc) ; 

// dessiner le repere : 

$grisfonce = imagecolorallocate ($image, 20, 20, 20); 

imagesetthickness ( $image, 2); 

imageline ( 

$ image, 

$ repere [' origine' ] ['x'], 

$repere [ ' maxY' ] , 

$ repere [' origine' ] ['x'], 

$ repere [' origine' ] ['y'], 

$grisf once 
); 
imageline ( 

$image, 

$ repere [' origine' ] ['x'], 

$ repere [' origine' ] ['y'], 

$repere [ ' maxX' ] , 

$ repere [' origine' ] ['y'], 

$grisf once 
); 

/* 

futur code 

*/ 
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imagepng ($ image ) ; // ecrit l'image 

imagedestroy ($image) ; // detruit la "resource" image 

?> 

Vous pouvez d'ores et deja admirer l'incroyable resultat en lan9ant ce fichier depuis votre 
navigateur prefere. 

Remarquez bien que la premiere chose que nous faisons apres avoir cree notre image avec 
la fonction imagecreate(), c'est de lui assigner une couleur de fond. 

Nous dessinons ensuite les deux axes de notre repere orthonorme. Pour ce faire, nous 
commencons par definir la couleur que nous allons utiliser. Nous utilisons alors la 
fonction imagesetthickness() arm de donner une epaisseur de 2 pixels aux traits que 
nous allons tracer. Les deux lignes sont ensuite tracees grace a imagel ine(). 

Imageline() 

Cette fonction vous permet de tracer une ligne sur une image. 

Syntaxe bool imageline (resource image, intxi, int yl, int x2, int 

y2, int color) 

Image L'image sur laquelle nous allons tracer le trait. 

xl L'abscisse du point de depart de notre ligne. 

yl L'ordonnee du point de depart de notre ligne. 

x2 L'abscisse du point d'arrivee de notre ligne. 

y2 L'ordonnee du point d'arrivee de notre ligne. 

Nous calculons les coordonnees de ces lignes en prenant en compte la hauteur et la 
largeur de notre image. Cela nous permettra d' avoir des graphiques de tailles differentes 
simplement en changeant les variables $largeur et $hauteur. 

Nous allons maintenant faire apparaitre tout ce qui se doit d'etre ecrit sur notre 
histogramme : 

//ecrit le titre du graphique 

$rouge = imagecolorallocate ($image, 220, 30, ) ; 

imagestring ($image, 

5, 10, 

$hauteur-20, 

$graphique_data [' titre' ] , 

$ rouge) ; 
imagestring ($image, 
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$graphique_data ['configuration'] ['unite'], 
$grisfonce) ; 
imagestring ( $image, 
5, 40, 

$hauteur-75, 
" " , 
$grisfonce) ; 

Enfin, nous allons faire apparaitre les barres de notre histogramme : 

//fait apparaitre les barres de 1' histogramme 
// calcul de la largeur des barres : 
$largeurBarre = $repere [ ' longueurAbscisse' ] / 

( (count 

($graphique_data [' enregistrements' ] ) 

*2 

)+l); 

$bleu = imagecolorallocate ($image, 0, 20, 230); 
for($i = ; 

$i < count ($graphique_data [' enregistrements' ] ) ; 

$i++) { 
// calcul des coordonnees des deux angles de la barre 
$barre = array ( 

' xl ' => $repere ['origine'] ['x']+((($i*2)+l) *$largeurBarre) , 

'yl' => $repere [' origine' ][' y' ]-( ($repere [' longueurOrdonnee' ] 

*» *$graphique_data [' enregistrements' ] [$i] [ ' valeur' ] ) /$graphique 

*» data [' configuration' ] [ 'maximum' ] ) , 

'x2' => $repere [' origine' ] ['x' ] + (( ($i*2) +2) *$largeurBarre) , 

' y2 ' => $repere [' origine' ] ['y'] 
) ; 

// dessine le rectangle (la barre) 

imagef illedrectangle ($image, $barre [ ' xl' ] , $barre [' yl' ] , 

$barre [' x2' ] , $barre [ ' y2' ] , $bleu) ; 



Certaines formules mathematiques utilisees ici peuvent paraitre barbares mais, 
rassurez-vous, la plus compliquee n'est qu'un simple produit en croix. 

Lorsque vous testez ce fichier, votre histogramme apparait correctement dans votre 
image. Vous pouvez deja changer les parametres du fichier graphique_data.php pour vous 
amuser et, par la meme occasion, apprecier la puissance de GD2. 

Nous allons maintenant modifier cette derniere portion de code arm d'integrer sur notre 
image les dernieres informations qui nous manquent. A savoir : le nom de chacun des 
enregistrements, ainsi que - dans un souci de precision - sa valeur. 
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Voici l'ensemble du code du fichier graphique.php contenant les dernieres modifications. 
A vous de les trouver ! 

fl^ graphique.php 

<?php 

header ( "Content-type : image/png") ; 

requireonce (' graphique_data . php' ) ; // importe le tableau 

$largeur = 800; 
$hauteur = 600; 

// information sur le repere 
$repere = array ( 

'origine' => array ( 

'x' => 50, 

' y' => $hauteur-75 



'maxY' => 5, 
'maxX' => $largeur-20 
); 
$repere [ ' longueurOrdonnee' ] = $repere [' origine' ] ['y'] 

-$repere [ ' maxY' ] ; 
$repere [ ' longueurAbscisse' ] = $repere ['maxX' ] 

-$repere [ ' origine' ] [ ' x' ] ; 

// creer une image a palette 

$image = imagecreate ($largeur, $hauteur) ; 

// donner un fond a 1' image 

$blanc = imagecolorallocate ($image, 255, 255, 255); 

imagef ill ($image, 0, 0, $blanc) ; 

// dessiner le repere 

$grisfonce = imagecolorallocate ($image, 20, 20, 20); 

imagesetthickness ( $image, 2); 

imageline ($ image, $repere [' origine' ][' x' ] , $repere [' maxY' ] , 

$ repere ['origine' ] ['x' ] , $ repere ['origine'] ['y'], 

$grisfonce) ; 
imageline ($ image , $repere['origine' ] ['x' ] , $ repere [' origine' ] [ ' y' ] , 

$repere [ ' maxX' ] , $repere [' origine' ][' y' ] , $grisfonce) ; 

//ecrit le titre du graphique 

$rouge = imagecolorallocate ($image, 220, 30, 0); 
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imagestring ($image, 5, 10, $hauteur-20, $graphique_data [ ' titre' ] , 

$rouge) ; 
imagestring ($image, 5, $repere [' origine' ] [ ' x' ] +5, 

, $graphique_data [ ' configuration' ] [ ' unite' ] , 

$grisfonce) ; 
imagestring ($image, 5, 40, $repere [' origine' ] ['y'], 

"0", $grisfonce) ; 

//fait apparaitre les barres de 1' histogramme 
// calcul de la largeur des barres : 
$largeurBarre = $repere [ ' longueurAbscisse' ] / 

( (count ($graphique_data [ ' enregistrements' ] ) 

*2)+l); 

$bleu = imagecolorallocate ($image, 0, 20, 230); 
for($i = ; 

$i<count ($graphique_data [' enregistrements' ] ) ; 
$i++) { 
// calcul des coordonnees des deux angles de la barre 
$barre = array ( 

' xl ' => $repere ['origine'] ['x']+((($i*2)+l) *$largeurBarre) , 
'yl' => $repere [' origine' ] ['y'] 

- ( ($repere [ ' longueur Or donnee' ] 

*$graphique_data [' enregistrements' ] [$i] ['valeur']) 
/$graphique data [' configuration' ] ['maximum']), 
' x2 ' => $repere ['origine'] ['x']+((($i*2)+2) *$largeurBarre ) , 
' y2 ' => $repere [' origine' ] ['y']-2 
) ; 

// dessine le rectangle (la barre) 

imagef illedrectangle ($image, $barre [ ' xl' ] , $barre [' yl' ] , 

$barre [' x2' ] , $barre [ ' y2' ] , $bleu) ; 
// Ecrit le nom de 1' enregistrement 
imagestringup ($image, 5, $barre [' xl' ] , $barre [ ' y2' ] -2, 

$graphique_data [' enregistrements' ] [$i] ['nom' ] , 
$blanc) ; 
// Ecrit la valeur de 1' enregistrement 
imagestring ($image, 5, $barre [' xl' ] , $barre [ ' yl' ] -15, 

$graphique_data [' enregistrements' ] [$i] ['valeur'], 
$grisfonce) ; 
} 

imagepng ( $image) ; // ecrit l'image 

imagedestroy ($image) ; // detruit la "resource" image 
?> 
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Fig. 3.4 : Et voila legraphique 

3.3 Utiliser ImageMagick et MagickWand 

Meme si GD2 est relativement simple d' installation et d'utilisation, il reste souvent bien 
limite. Quid des effets d'images traditionnels, comme le flou ? Quid des polices de 
caracteres et de leur orientation ? L'ensemble ImageMagick et MagickWand repond bien 
a cette problematique, et parfois meme, plus rapidement que GD2. En contrepartie, 
1' installation de cette extension est assez particuliere, autant dire qu'elle est rarement 
presente sur les serveurs mutualises. 

Installation 

ImageMagick est un programme de retouche d'images qu'il est necessaire d'installer sur 
votre machine arm de pouvoir utiliser ses puissantes fonctionnalites. Pour le telecharger, 
rendez-vous a l'adresse http://www.imagemagick.org/, et choisissez la version 8 ou 16 bits 
suivant la puissance de votre ordinateur. Double-cliquez ensuite sur le fichier executable 
obtenu, et suivez la procedure d'installation. 

Une fois 1' installation terminee, ouvrez une fenetre de commande (choisissez Invite de 
commandos dans le menu Demarrer/Programmes/Accessoires). Depuis PInvite de 
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commandes, deplacez-vous dans un dossier contenant des images, puis entrez la 
commande (en remplacant logo.gif par le nom d'une de vos images): Imdi splay 
logo.gif. 

L'interface de ImageMagick s'ouvre sur cette image. Le programme est correctement 
installe, vous pouvez fermer ImageMagick. 

MagickWand est ce que Ton appelle un wrapper. II permet d'utiliser directement les 
fonctions de ImageMagick en les appelant avec des fonctions PHP. 

Comme l'immense majorite des extensions PHP, MagickWand se trouve sous forme de 
fichiers All. Pour les recuperer, allez a l'adresse http://www.magickwand.org/download/php/ 
windows/ et telechargez les fichiers php_magickwand_dyn.dll et php_magickwand 
_ql6_st.dll, ainsi que la documentation. 

Copiez vos fichiers All dans le repertoire des extensions de PHP, puis editez votre fichier 
php.ini afin de declarer ces nouvelles extensions. Relancez Apache. Le tour est joue. 

Nous allons maintenant ecrire le fichier magickwandtest.php, que nous placons dans notre 
repertoire chap03. Ce fichier a pour but d' ecrire une phrase sur une image et nous 
permettra de verifier le bon fonctionnement de 1' installation. 

Voici le code de magickwandtest.php : 

^j magickwandtest.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 
// creer un objet MagickWand 
$magick_wand=NewMagickWand ( ) ; 

// ouvre une image 

MagickReadlmage ( $magick wand, ' images/guitare . jpg' ) ; 

// creer un objet DrawingWand 

$drawing_wand=NewDrawingWand ( ) ; 

// Choix d'une police de caracteres/ 

DrawS et Font ($drawing_wand, "impact. ttf " ) ; 

// Reglage de la taille du texte/ 

DrawSetFontSize ( $drawing_wand, 20 ) ; 

// outil de centrage/ 

DrawSetGravity ($drawing_wand, MW CenterGravity) ; 

//creer un objet PixelWand 
$pixel_wand=NewPixelWand ( ) ; 
PixelSetColor ( $pixel wand, "white" ) ; // choix de la couleur 
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// choisit la couleur a utiliser pour remplir les objets, a partir de 
** la couleur d'un objet PixelWand. 
DrawSetFillColor ($drawing wand, $pixel wand) ; 

// Ecrit sur 1' image 

if (MagickAnnotatelmage ( $magick wand, $drawing wand, 0, 0, 0, 

"salut le monde ! ! !") != 0) { 

MagickEchoImageBlob ( $magick wand ) ; 
} else { 

echo MagickGetExceptionString ($magick wand) ; 
} 
?> 

Avant de lancer ce nchier depuis votre navigateur favori, assurez-vous de cibler une 
image existante et un nchier de police de caracteres egalement existant (vous pouvez 
copier un nchier de police de caracteres dans le meme repertoire que celui de votre nchier 
magickwandtest .php) . 

MaTtriser des effets pour les images 

Explorer entierement MagickWand demanderait un ouvrage complet sur le sujet : c'est 
pourquoi nous n'allons voir qu'une toute petite partie de ce programme, mais qui reste 
impressionnante, puisque nous allons traiter des nitres. 




Fig. 3.5 : L'image que nous utilisons pour illustrer cette section 
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Appliquer des effets 

Nous allons commencer par simplement flouter une image. Pour cela, creez dans votre 
repertoire chap03 un fichier intitule magiclcphp : 



<^ magick.php 



<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand=NewMagickWand ( ) ; 

// ouvre une image 

MagickReadlmage ( $magick wand, ' images/guitare . jpg' ) ; 

// Ecrit sur 1' image 

if ( ! MagickBlurlmage ($magick wand, 20, 5)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickEchoImageBlob ( $magick wand ) ; 
?> 

Si vous ouvrez magicLphp depuis votre navigateur, vous trouverez votre image 
completement floue. Regardons le code d'un peu plus pres. 

La premiere ligne que nous ecrivons concerne la fonction header () qui, apres avoir vu le 
fonctionnement de GD2, doit vous sembler evidente. 

Tout de suite apres, nous creons un objet MagickWand, grace a la fonction 
NewMagickWandQ. Cet objet est celui qui chargera l'image que nous souhaitons modifier, 
et c'est par lui que s'y appliqueront toutes les modifications. 

La fonction MagickReadlmageQ nous permet de preciser l'adresse de l'image que nous 
souhaitons arranger a notre facon. Comme nous chargeons une image de type JPEG, 
MagickWand creera en sortie une image de type JPEG ; ce qui explique le content-type 
de la fonction header (). 

Maintenant que notre image est en memoire, nous allons la flouter grace a la fonction 

MagickBlurImage(). 



1 IB 



Utiliser ImageMagick et MagickWand 



MagickBlurlmage() 

Cette fonction permet d'appliquer un effet flou a une image. 

Syntaxe bool Magi ckBlurlmage (Magi ckWand mgck_wnd, float radius, 

float sigma [, int channel_type]) 

mgck_wnd L'objet MagickWand, reference de l'image sur laquelle nous 

souhaitons appliquer l'effet. 

Radius Le rayon de notre effet flou. 

Sigma Le parametre sigma de notre effet flou. 

channel type Doit correspondre a l'une des constantes correspondant a un canal 

couleur, permettant de n' appliquer l'effet que sur le canal rouge, 
par exemple. 

Le dernier argument de cette fonction permet de specifier un canal couleur particulier sur 
lequel s'appliquera la transformation. II doit prendre pour valeur la constante 
correspondant au canal couleur souhaite. 

Modifiez votre code de la maniere suivante : 

if ( IMagickBlurlmage ($magick wand, 20, 5, MW MagentaChannel) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

Maintenant, seul le canal magenta de votre image est floute, lui donnant ainsi une touche 
tres... fluo. 

Voici les differentes constantes utilisables dans ce contexte : 

MW_RedChannel 

MW_GreenChannel 

MW_BlueChannel 

MW_CyanChannel 

MW_MagentaChannel 

MW_YellowChannel 

MW_BlackChannel 

MW_AlphaChannel 

MW OpacityChannel 
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MW_IndexChannel 
MW_A11 Channels 

Magic kWand propose d' autre types de flous, via des fonctions tres semblables a 
MagickBlurImage(). Les voici : 

bool MagickGaussianBlurImage( MagickWand mgck_wnd, float radius, float 

sigma [, int channel_type] ) 

bool MagickMotionBlurImage( MagickWand mgck_wnd, float radius, float sigma, 

float angle ) 

bool MagickRadialBlurImage( MagickWand mgck_wnd, float angle ) 

Bien stir, il existe dans MagickWand un certain nombre d'effets. En voici quelques-uns : 

bool MagickOil Paintlmage( MagickWand mgck_wnd, float radius ): effet 
"peinture a l'huile" ; 

bool MagickRaiseImage( MagickWand mgck_wnd, float width, float height, int 
x, int y, bool raise ) : ajoute un petit effet 3D a l'image, lui donnant l'apparence 
graphique d'un bouton standard ; 

bool Magi ckSwirl Image ( MagickWand mgck_wnd, float degrees ) : effet tourbillon ; 
I bool MagickNegateImage( MagickWand mgck_wnd [, bool only_the_gray [, int 
channel _type]] ) : donne le negatif de l'image ; 
Etc. 

Vous voulez superposer plusieurs nitres ? Voici la marche a suivre : 

// ouvre une image 

MagickReadlmage ( $magick wand, ' images/guitare . jpg' ) ; 

// Joue sur le negatif 

if ( IMagickNegatelmage ($magick wand, false, MW YellowChannel) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickEchoImageBlob ( $magick wand ) ; 
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Fig. 3.6 : Voici a quoi ressemble notre guitare apres un tel traitement 

Superposer des images 

Nous allons maintenant superposer une seconde image par-dessus la premiere. 




Fig. 3.7 : Voici I'image que nous allons utiliser pour la superposition 
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^j magick.php 



<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand=NewMagickWand ( ) ; 

// creer un objet MagickWand 
$magick wand2=NewMagickWand ( ) ; 

// ouvre une image 

MagickReadlmage ( $magick wand, ' images/guitare . jpg' ) ; 

// ouvre une seconde image 

MagickReadlmage ( $magick wand2 , ' images/redf ish . gif ' ) ; 

// Joue sur le negatif 

if ( JMagickNegatelmage ($magick_wand, false, MW_YellowChannel) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

// Effet tourbillon 

if ( IMagickSwirllmage ($magick_wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

// superposer 1' image 

if ( ! MagickAddlmage ( $magick wand, $magick_wand2) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickEchoImageBlob ( MagickFlattenlmages ($magick wand) ); 
?> 

II est necessaire de creer un second objet Magi ckWand, arm de charger une seconde image. 
Des nitres peuvent etre appliques separement sur chacune des images. La superposition 
des deux images se fait en deux temps. D'abord, nous les associons grace a la fonction 
MagickAddImage(). Ce faisant, les deux images se fondent en une, mais sous forme de 
caiques distincts. Chaque objet MagickWand peut encore subir des transformations 
independamment de l'autre. C'est la fonction MagickFlattenImage() qui va reellement 
superposer les deux images en une seule. 
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Fig. 3.8 : Le resultatde la superposition 

Si vous utilisez la fonction Magi c k Flatten Image ()avant d'appliquer vos filtres (ou tout 
autre transformation), ils s'appliqueront sur les deux images : 

// superposer 1' image 

if ( IMagickAddlmage ($magick_wand, $magick_wand2) ) { 

echo MagickGetExceptionString ($magick_wand) ; 
} 

$magick wand = MagickFlattenlmages ($magick wand) ; 

// Joue sur le negatif 

if ( IMagickNegatelmage ($magick wand, false, MW YellowChannel) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 
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Fig. 3.9 : Les filtres ont ete appliques sur les deux images. 

Compresser et enregistrer une image 

A ce stade, il ne nous reste plus qu'a enregistrer l'image sur le disque. Pour ce faire, 
modinez votre code de la facon suivante : 

// Effet tourbillon 

if ( IMagickSwirllmage ($magick_wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickWritelmage ($magick wand, "images/magick. jpg" ) ; 
MagickEchoImageBlob ( $magick wand ) ; 

La fonction MagickWriteImage() va creer le fichier magick.jpg a l'adresse passee en 
argument. Par contre, l'image qui a ete enregistree pese assez lourd. 
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magick.jpg 
691 x511 
Image JPEG 



Dimensions : 691 x 511 
Type : Image JPEG 
Taille : 215 Ko 
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Fig. 3.10: 

Le fichier cree pese assez lourd 



Nous allons done rajouter une ligne de code pour profiter de la compression JPEG, juste 
avant la fonction MagickWri telmage() (car cela ne sert a rien de compresser alors que 
Ton a deja enregistre l'image) : 

MagickSetlmageCompressionQuality ( $magick wand, 50); 

Le second argument de cette fonction represente le taux de compression. A 100, la qualite 
de votre image sera optimale. A 1, votre image sera d'une qualite deplorable (a moins 
qu'il ne s'agisse d'un parti-pris artistique), mais elle ne pesera plus bien lourd. 

Fig. 3.11 : 

Avec un taux de compression de 50, notre 
image s'est grandement allegee 





_~*| magick.jpg 
■II 691x511 
M Image JPEG 




Dimensions : 691 x 511 
Type : Image JPEG 
Taille ! 23, 1 Ko 


L 




1 



Voici, pour terminer, le code complet de magickphp : 



&fi magick.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand=NewMagickWand ( ) ; 

// creer un objet MagickWand 
$magick wand2=NewMagickWand ( ) ; 

// ouvre une image 

MagickReadlmage ( $magick wand, ' images/guitare . jpg' ) ; 

// ouvre une seconde image 

MagickReadlmage ( $magick wand2 , ' images/redf ish . gif ' ) 

// superposer l'image 
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if ( ! MagickAddlmage ( $magick wand, $magick_wand2) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

$magick wand = MagickFlattenlmages ($magick wand) ; 

// Joue sur le negatif 

if ( IMagickNegatelmage ($magick_wand, false, MW_YellowChannel) ) 

echo MagickGetExceptionString ($magick wand) ; 
} 

// Effet tourbillon 

if ( IMagickSwirllmage ($magick_wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickSetlmageCompressionQuality ($magick wand, 50); 
MagickWritelmage ($magick wand, "images/magick. jpg" ) ; 

MagickEchoImageBlob ( $magick wand ) ; 
?> 



L'objet DrawingWand 

En plus de pouvoir appliquer de puissants effets a nos images, MagickWand nous offre 
aussi de nombreux outils de dessins. Nous allons nous familiariser avec un premier 
exemple de l'utilisation de l'objet Drawi ngWand. 

Dans chap03, creez le fichier magick_draw.php, et ajoutez le code suivant : 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand = NewMagickWand ( ) ; 

// ouvre une image 

MagickReadlmage ( $magick wand, "images/guitare. jpg" ) ; 

//creer un objet PixelWand 
$pixel_wand=NewPixelWand ( ) ; 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 



Nous creons toujours un objet MagickWand, et ouvrons toujours une image de la meme 
maniere que precedemment. Nous creons aussi deux nouveaux objets : un PixelWand et 
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un DrawingWand. Vous pouvez imaginer le Drawn ngWand comme etant un pinceau, un outil 
de dessin que nous pourrons decrire arm d'en faire varier la forme, et le Pixel Wand 
comme etant la peinture que nous allons utiliser avec le pinceau. 

Completez le code comme suit : 

// dessiner 10 cercles dont la taille, 1' emplacement, la couleur 
// et la transparence seront determines par le hasard : 

$couleur = Array ( 

"white", 

"blue", 

"red", 

"green" , 

"yellow") ; 
for ($i = ; $i < 10 ; $i++) { 

// choix de la couleur : 

PixelSetColor ($pixel_wand, $couleur[rand(0, 4 ) ] ) ; 

// on lie la couleur (l'objet $pixel_wand) 
// au dessin (l'objet $drawing_wand) : 
DrawSetFillColor ($drawing wand, $pixel wand); 

// on determine la transparence (alpha) de la couleur 

// de remplissage : 

DrawSetFillAlpha ($drawing_wand, rand(0, 33)/100); 

// on determine les coordonnees du cercle : 

$ox = rand(10, MagickGetlmageWidth ($magick wand) -10); 

$oy = rand(10, MagickGetlmageHeight ($magick wand)-10); 

$px = rand($ox, MagickGetlmageWidth ( $magick wand) -10); 

$py = rand($oy, MagickGetlmageHeight ($magick wand) -10); 

// on rajoute notre cercle dans la liste 
// "dessins a faire" de l'objet $drawing wand : 
DrawCircle ( $drawing_wand, $ox, $oy, $px, $py) ; 
} 

// on dessine sur 1' image la totalite des dessins 
// contenus dans la liste des "dessins a faire" 
// de l'objet $drawing wand : 
MagickDrawImage ( $magick wand, $drawing wand) ; 

Ce petit bout de programme va dessiner dix cercles de couleur, de taille et d'opacite 
variables par-dessus notre image. L'ordre des instructions est important. 
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A peine la boucle for commencee, nous appliquons une couleur a $pixel_wand, via la 
fonction PixelSetColorQ. Dans notre exemple, la valeur de la couleur est choisie au 
hasard dans un tableau. Cette fonction accepte les noms de couleur standard sous forme 
de chaines de caracteres (comme dans notre exemple), ou les couleurs sous leur forme 
hexadecimale (exemple : #FFFFFF). 

Nous lions ensuite $pixel_wand et $drawing_wand avec la fonction DrawSetFil lColor() : 
c'est un peu comme tremper notre pinceau dans un seau de peinture. 

La fonction DrawSetFi 1 lAlpha() permet de donner de la "transparence" a notre pinceau. 
Le second parametre de cette fonction est de type f 1 oat et est contenu entre 
(completement transparent) et 1 (completement opaque). 

Une fois que nous avons determine la couleur et l'opacite de notre pinceau et de notre 
peinture, nous allons nous occuper de tracer un cercle. Pour cela, nous utilisons 
simplement la fonction DrawCircle(). Celle-ci a besoin de savoir quel pinceau va la 
dessiner (c'est le premier argument de cette fonction), mais elle demande aussi quatre 
autres arguments de type float. II s'agit des coins superieur gauche et inferieur droit du 
rectangle dans lequel notre cercle s'inscrira. 

A cette etape, notre cercle n'est pas encore dessine sur l'image. La fonction 
DrawCircleQ n'a fait qu'ajouter notre cercle dans une liste des "trues a dessiner". Ainsi, 
notre boucle for va repeter dix fois cette suite d' instructions et inscrire dix fois dans la 
liste des "trues a dessiner" qu'il faut dessiner un cercle aux proprietes aleatoires. 

Vient enfm la fonction qui va dessiner le contenu de la liste de l'objet DrawingWand : 
MagickDrawImageQ. 

Nous terminons alors notre script ainsi : 

// Joue sur le negatif 

if ( IMagickNegatelmage ($magick wand, false, MW YellowChannel) ) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickSetlmageCompressionQuality ($magick wand, 85); 
MagickWritelmage ($magick_wand, " images /magick. jpg") ; 

MagickEchoImageBlob ( $magick wand ) ; 
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De cette maniere, les effets "tourbillon" et "negatif ' s'appliquent aussi sur les cercles que 
nous venons de dessiner. 




Fig. 3.1 2 : Un des nombreux resultats possibles 
Voici le code complet du fichier magick_draw.php : 

J^£ magick_draw.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 

// creer un objet MagickWand 
$magick wand = NewMagickWand ( ) ; 

// ouvre une image 

MagickReadlmage ( $magick_wand, " image s/gu it are . jpg") 

//creer un objet PixelWand 
$pixel_wand=NewPixelWand ( ) ; 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 
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// dessiner 10 cercles dont la taille, 1' emplacement, la couleur 
// et la transparence seront determines par le hasard : 

$couleur = Array ( 

"white", 

"blue", 

"red", 

"green" , 

"yellow") ; 
for ($i = ; $i < 10 ; $i++) { 

// choix de la couleur : 

PixelSetColor ($pixel_wand, $couleur[rand(0, 4 ) ] ) ; 

// on lie la couleur (l'objet $pixel_wand) 
// au dessin (l'objet $drawing_wand) : 
DrawSetFillColor ($drawing wand, $pixel_wand) ; 

// on determine la transparence (alpha) de la couleur 

// de remplissage : 

DrawSetFillAlpha ($drawing_wand, rand(0, 33)/100); 

// on determine les coordonnees du cercle : 

$ox = rand(10, MagickGetlmageWidth ($magick wand) -10); 

$oy = rand(10, MagickGetlmageHeight ($magick wand) -10); 

$px = rand($ox, MagickGetlmageWidth ($magick wand) -10); 

$py = rand($oy, MagickGetlmageHeight ($magick wand) -10); 

// on rajoute notre cercle dans la liste 
// "dessins a faire" de l'objet $drawing wand : 
DrawCircle ($drawing_wand, $ox, $oy, $px, $py) ; 
} 

// on dessine sur 1' image la totalite des dessins 
// contenus dans la liste des "dessins a faire" 
// de l'objet $drawing wand : 
MagickDrawImage ( $magick wand, $drawing wand) ; 



// Joue sur le negatif 

if ( IMagickNegatelmage ($magick_wand, false, MW_YellowChannel) ) 

echo MagickGetExceptionString ($magick wand) ; 
} 
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// Effet tourbillon 

if ( ! MagickSwirllmage ( $magick wand, -180)) { 

echo MagickGetExceptionString ($magick wand) ; 
} 

MagickSetlmageCompressionQuality ( $magick wand, 85); 
MagickWritelmage ($magick wand, "images/magick. jpg") 

MagickEchoImageBlob ( $magick wand ) ; 
?> 



Creer des avatars 

Imaginons que nous souhaitons, alors que nous developpons une application 
communautaire, creer un systeme d' avatars. Dans le cadre d'un forum, ce peut etre "la 
petite image que j'ai choisie et qui est apposee a cote de chacun de mes messages". Ann 
que chaque utilisateur dispose d'un avatar tres personnalise mais s'integrant tout de meme 
a une charte graphique, nous nous proposons de creer un petit script qui superpose 
differentes parties de visages les unes sur les autres. 

Fig. 3.13: 

Un exemple d' avatar tel que notre code nous 
permettra de le construire. 




Nous allons a cet effet creer deux fichiers. L'un, avatar _fonctions.php, contiendra un 
ensemble de fonctions qui manipuleront des objets Drawn ngWand. L'autre, avatar.php, 
assemblera ces DrawingWand au sein d'une image. 

Le principe general de notre script 

Voyons, pour commencer, le fichier avatar.php : 

fl^ avatar.php 

<?php 

header ( "Content-type : image/ jpeg" ) ; 
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include 'avatar f onctions . php' ; 

// tableau des parametres de 1' avatar 
$avatar = Array ( 

' couleur_peau' => "#d4c7a3", 

'couleur_contour' => "#000000", 

' opacite_contour' => 0.5, 

' epaisseur_contour' => 3, 



// creer un objet MagickWand 
$magick_wand = NewMagickWand ( ) ; 

// ouvre le fond blanc 

MagickReadlmage ( $magick wand, "images/blanc. gif " ) ; 

// Redimensionnement de notre image en 180*240 
MagickScalelmage ($magick wand, 180, 240); 

// utilisation des fonctions contenues dans 

// le fichier avatar fonctions .php : 

/* 

*/ 

// un petit effet flou, pour le plaisir : 
MagickGaussianBlurlmage ($magick wand, 2, 1, MW RedChannel) ; 

MagickEchoImageBlob ( $magick wand ) ; 
?> 

II y a, dans ce fichier, le tableau $avatar, qui decrit notre avatar. II nous permettra de 
changer a loisir les parametres de notre image. 

Ici, la fonction MagickReadImage() ouvre un fichier nomme blanc.gif. II s'agit d'une 
petite image de 5*5 pixels, toute blanche. C'est elle qui servira de fond au visage que 
nous allons dessiner. La fonction MagickScalelmageQ sert a redimensionner notre image 
a la taille que nous souhaitons. 

Le reste du code est, somme toute, classique. 

Le second fichier, avatar _f onctions. php, va contenir des fonctions manipulant des objets 
DrawingWand. Voici la premiere fonction que nous y ecrirons, et qui aura pour but de 
dessiner un cercle (representant la tete de notre avatar) : 
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&Q avatar_fonctions.php 

<?php 

function dessineTete ($conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 

$pxl peau = NewPixelWand () ; 

$pxl contour = NewPixelWand () ; 

PixelSetColor ($pxl_peau, $conf [ ' couleur_peau' ] ) ; 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 

DrawSetStrokeWidth ($drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ($drawing wand, $conf [ ' opacite contour']); 

DrawSetFillColor ($drawing wand, $pxl peau); 
DrawSetStrokeColor ($drawing wand, $pxl contour); 

DrawCircle ($drawing_wand, 

90, 150, //centre 
90, 205); //rayon 

return $drawing_wand; 
} 
?> 

Notre fonction, dessineTete(), prend un argument en parametre : $conf. II s'agit en fait 
du tableau $avatar decrit dans le fichier avatar.php, que nous lui passerons en parametre 
lors de son appel. Ce tableau est utilise pour recuperer des parametres concernant la tete : 
la couleur de la peau, 1' epaisseur du contour, etc. 

A propos de l'epaisseur du contour, il nous semble pertinent de signaler que chaque objet 
que nous allons dessiner dispose d'un fond et d'un contour, que vous pouvez faire 
apparaitre ou non en y attachant une couleur. Ainsi, dans notre exemple, nous nous 
assurons d'avoir un fond colore en appelant la fonction DrawSetFil lColor() ; et un 
contour visible en appelant la fonction DrawSetStrokeColor(). 

Nous utilisons aussi la fonction DrawSetStrokeAlphaQ : il s'agit de modifier la 
transparence de notre contour {stroke, en anglais). II existe une fonction similaire, 
DrawSetFi 1 1 Al pha(), qui permet de modifier la transparence de votre couleur de fond, de 
remplissage (fill, en anglais). En fait, beaucoup de fonctions dont le nom est compose 
avec le mot "stroke" ont une soeur jumelle, composee avec le mot "fill", et vice versa. 
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Une fois que nous avons configure nos "peintures" (les PiwelWand) et notre "pinceau" (le 
DrawingWand), nous pouvons dessiner le cercle grace a la fonction DrawCircleQ. 



DrawCircle ($drawingwand 

90, 150, int 1 

90, 205) ; // point 2 




point 2 (rayon) 



► Fig. 3.14: 

La fonction DrawCirclel! 



Le premier parametre de cette fonction est, vous l'aurez devine, notre objet DrawingWand. 
Les quatre parametres suivants decrivent deux points se situant dans le systeme de 
coordonnees de notre image (ou l'origine se trouve dans le coin superieur gauche). Le 
premier point (dans notre exemple : x = 90 et y = 150) represente le centre de notre 
cercle. Le second (dans notre exemple : x = 90 et y = 205) represente un point sur le 
cercle, c'est-a-dire que la droite formee par nos deux points est en fait le rayon du cercle 
que nous voulons tracer. 

Pour finir, notre fonction dessineTete() renvoie notre objet DrawingWand. Nous pouvons 
maintenant l'utiliser dans notre fichier avatar.php. Modifiez done son code comme suit : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions .php : 
MagickDrawImage ($magick_wand, dessineTete ($avatar ) ) ; 

/* 

* 

*/ 

Si vous lancez maintenant avatar.php, vous pourrez admirer un incroyable rond au bas de 
votre image. 
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Nous allons done continuer a creer des fonctions qui se chargeront de dessiner les yeux, 
le nez, la bouche, les oreilles (ou plutot, "l'oreille") et les cheveux. Mais avant cela, 
savez-vous ce qu'est une courbe de Bezier ? 

Les courbes de Bezier 

Les courbes de Bezier, comme leur nom l'indique, sont... des courbes. Comme vous vous 
en doutez, nous allons avoir besoin de tracer des courbes pour dessiner nos avatars, et les 
courbes de Bezier sont un outil ideal, mais surement un peu complique a la premiere 
approche. Rien de mieux qu'un bon dessin pour comprendre : 

► Fig. 3.15: 

Une courbe de Bezier 




Comme vous le voyez sur cette image, la courbe de notre exemple se compose de sept 
points. Neanmoins, ils ne suivent pas tous la courbe. En effet, seuls trois points 
(symbolises par des croix) se trouvent sur la courbe. Les points symbolises par des carres 
sont "relies" aux points en forme de croix. Ils indiquent la "direction" que doit prendre 
la courbe. Observez le cheminement de notre courbe entre le point 1 et le point 4 : la 
courbe part du point en direction du point 2, puis change de trajectoire pour aller vers le 
point 3 avant de passer sur le point 4. Bien sur, plus le point de direction est loin de son 
point de passage, plus son impact sur la courbe sera grand. Terminons cette breve 
explication par une regie importante : il y a toujours deux points de direction entre deux 
points de passage. 

Pour tracer une courbe de Bezier avec MagickWand, nous allons, vous vous en doutez, 
avoir besoin des coordonnees de chacun de ces points. Voici comment nous coderions la 
courbe de notre exemple : 



DrawBezier ( $ob jet dr 


awing wand, array ( 




20, 140, 


// point 1 




30, 60, 


// point 2 




70, 70, 


// point 3 




100, 40, 


// point 4 
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130, 


10, 


// point 5 


210, 


60, 


// point 6 


180, 


160) >; 


// point 7 



/j\ La fonction DrawBezier ne prend que 2 arguments. 

La liste de nos points doit etre passee en parametre a cette fonction sous la forme d'un tableau. 

Maintenant que nous savons coder une courbe de Bezier, nous allons rajouter deux 
fonctions de dessin : l'une pour dessiner la bouche, l'autre pour dessiner l'oreille. 
Rajoutez le code suivant dans avatar_fonctions.php : 

function dessineOreille ($conf ) { 
// creer un objet DrawingWand 
$drawing wand = NewDrawingWand () ; 

//creer des PixelWand 

$pxl peau = NewPixelWand () ; 

$pxl contour = NewPixelWand () ; 

PixelSetColor ( $pxl_peau, $conf [ ' couleur_peau' ] ) ; 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 

DrawSetStrokeWidth ($drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ($drawing wand, $conf [ ' opacite contour']); 

DrawSetFillColor ($drawing wand, $pxl_peau) ; 
DrawSetStrokeColor ($drawing wand, $pxl contour); 

DrawBezier ($drawing_wand, array ( 



132, 


150, 


//point 


1 


138, 


132, 


//point 


2 


159, 


144, 


//point 


3 


150, 


165, 


//point 


4 


138, 


186, 


//point 


5 


120, 


177, 


//point 


6 


126, 


168) ); 


//point 


7 



return $drawing wand; 



} 



function dessineBouche ($conf ) { 
// creer un objet DrawingWand 
$drawing_wand = NewDrawingWand ( ) 
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//creer un PixelWand 

$pxl contour = NewPixelWand ( ) ; 

PixelSetColor ( $pxl contour, $conf [' couleur contour']); 

DrawSetStrokeWidth ($drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ($drawing wand, $conf [ ' opacite contour']); 

DrawSetFillAlpha ($drawing wand, 0) ; 
DrawSetStrokeColor ($drawing_wand, $pxl_contour ) ; 

DrawBezier ( $drawing_wand, array ( 
42, 168, //point 1 
54, 198, //point 2 
111, 192, //point 3 
114, 168) ) ; //point 4 

return $drawing wand; 



} 



Ce n'est pas tres complique, n'est-ce pas ? Notez cependant que nous n'utilisons pas de 
couleur de fond pour la bouche : nous n'avons que le trait du contour... Alors que 
l'oreille est quand meme coloriee avec une couleur, meme si notre forme n'est pas 
fermee. 

Completons notre fichier avatar.php arm qu'il prenne en compte nos nouvelles fonctions 
et dessine effectivement une bouche et une oreille : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions .php : 

MagickDrawImage ( $magick wand, dessineTete ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineOreille ($avatar) ) ; 
MagickDrawImage ( $magick_wand, dessineBouche ($avatar ) ) ; 

Et voila ! Notre magnifique rond se retrouve affuble d'une bouche et d'une oreille. 

Fermer proprement ses courbes de Bezier 

La fonction que nous allons creer maintenant dessinera les cheveux. Vu la complexite de 
la forme, nous allons utiliser une courbe de Bezier que nous allons refermer. Mais 
comment fermer une courbe de Bezier ? Rien de plus facile, observez ce schema : 
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3 point 9 

^_42Qint1 
'Sri poTnTTB — 


point 6 
r~ 
point 7 


a 

point 2 


□ 




DPpfntS 




point 4 


1 

□ 
point 


3 



► Fig. 3.16: 

Une courbe de Bezier 

fermee 



Le dernier point de la courbe est tout simplement le meme que le premier. Voici comment 
nous pourrions coder cette courbe avec MagickWand : 



DrawBezier ($ob jet dr 


awing 


wand, 


array ( 


50, 60, 


if 


point 


1 


90, 100, 


II 


point 


2 


80, 190, 


II 


point 


3 


90, 160, 


II 


point 


4 


100, 130, 


II 


point 


5 


210, 70, 


II 


point 


6 


160, 80, 


II 


point 


7 


110, 90, 


II 


point 


8 


10, 20, 


II 


point 


9 


49, 60)); 


II 


point 


10, bouclage 



Comme vous le remarquez justement, le dernier point ne se trouve pas exactement aux 
memes coordonnees que le premier. En effet, si le premier et le dernier point se 
superposent parfaitement, MagickWand fera une petite erreur de rendu. 

Revenons a nos cheveux. Comme nous avons besoin d'un parametre supplemental, qui 
est la couleur des cheveux, nous allons le rajouter au tableau $avatar du fichier 
avatar.php : 



// tableau 


des paramet 


res de 


1' 


avat 


ar 


$avatar = 


Array ( 














' couleur 


peau' => 


"#d4 


c7a3" 


/ 






' couleur 


contour' 


=> 


M 


#000000 






' opacite 


contour' 


=> 





■ 5, 








'epaisseur contour 


, . 


=> 


3, 
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'couleur_cheveux' => "#985d36" 
); 

Ensuite, rajoutez cette fonction dans votre fichier avatar_fonctions.php : 

function dessineCheveux ($conf ) { 
// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 

$pxl cheveux = NewPixelWand () ; 

$pxl contour = NewPixelWand () ; 

PixelSetColor ( $pxl cheveux, $conf [' couleur cheveux']); 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 

DrawSetStrokeWidth ($drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ($drawing wand, $conf [ ' opacite contour']); 

DrawSetFillColor ($drawing_wand, $pxl cheveux) ; 
DrawSetStrokeColor ($drawing wand, $pxl contour); 

DrawBezier ($drawing_wand, array ( 
24, 123, //point 1 
35, 68, //point 2 

165, 68, 165, 85, 166, 121, 153, 177, //points 3 a 6 

132, 174, //points 7 a 10 
132, 150, //points 11 a 14 
114, 165, //points 15 a 18 
154, 92, //points 19 a 22 
//points 23 a bouclage 



Et voila ! La fonction DrawBezier() peut sembler effrayante, avec ces coordonnees de 
24 points. Mais fmalement, rien de sorcier, n'est-ce pas ? 

Completons done notre fichier avatar.php arm qu'il dessine aussi les cheveux : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions .php : 

MagickDrawImage ( $magick wand, dessineTete ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineCheveux ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineOreille ($avatar) ) ; 
MagickDrawImage ( $magick_wand, dessineBouche ($avatar ) ) ; 

Notez que nous utilisons la fonction dessinant les cheveux avant celle dessinant l'oreille. 
Les deux formes se superposant, il faut bien que l'une apparaisse au-dessus de l'autre. 
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144, 


183, 


141, 180, 


132, 174, 


138, 


165, 


138, 165, 


132, 150, 


126, 


162, 


126, 162, 


126, 162, 


111, 


162, 


117, 156, 


120, 138, 


102, 


138, 


36, 130, 


25, 123)); 


return $drawing 
} 


wand 
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C'est done l'ordre dans lequel nous appelons nos fonctions qui va determiner quelle 
forme sera au-dessus. 

Que nous manque-t-il, pour terminer notre avatar ? Les yeux et le nez. Mais vous avez 
deja compris comment les dessiner. Nous allons corser un peu l'exercice en donnant la 
possibilite de parametrer le rayon des yeux. De plus, comme nous avons choisi une pose 
de trois quarts pour le visage de notre avatar, le nez se trouvera, en termes de 
superposition de formes, entre les deux yeux. C'est-a-dire qu'il devra apparaitre 
par-dessus l'ceil droit de notre avatar, et par-dessous l'oeil gauche. Voici comment nous 
nous y prenons pour realiser une telle fonction : 

function dessineYeuxEtNez ($conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 
$pxl oeil = NewPixelWand ( ) ; 
$pxl iris = NewPixelWand () ; 
$pxl contour = NewPixelWand () ; 
$pxl peau = NewPixelWand () ; 

Pixel SetColor ($pxl_oeil, $conf [ ' couleur_oeil' ] ) ; 
PixelSetColor ( $pxl iris, $conf [ ' couleur iris']); 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 
PixelSetColor ($pxl_peau, $conf [ ' couleur_peau' ] ) ; 

DrawSetStrokeWidth ($drawing wand, $conf [ ' epaisseur__contour' ] ) ; 
DrawSetStrokeAlpha ($drawing wand, $conf [ ' opacite contour']); 

// 1' oeil droit : 

DrawSetFillColor ($drawing wand, $pxl oeil); 
DrawSetStrokeColor ($drawing wand, $pxl contour); 
DrawCircle ($drawing wand, 

60, 150, //centre 

60, 150+$conf [' rayon_oeil' ] ) ; //rayon 

// 1' iris droit : 

DrawSetFillColor ($drawing wand, $pxl iris); 

DrawCircle ($drawing wand, 

63, 150, //centre 

60, 150+($conf ['rayon_oeil' ] /4) ) ; //rayon 

// le nez 

DrawSetFillColor ($drawing wand, $pxl_peau) ; 

DrawBezier ($drawing_wand, array ( 

75, 150, 63, 159, 75, 171, 78, 168)); 
// l'oeil gauche : 
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DrawSetFillColor ($drawing 


wand, $pxl oeil); 






DrawCircle ( $drawing wand, 








90, 150, 


//centre 






90, 150+$conf[' 


rayon oeil' ] ) ; // 


rayon 




// l'iris gauche : 








DrawSetFillColor ($drawing 


wand, $pxl iris); 






DrawCircle ( $drawing wand, 








93, 150, 


//centre 






93, 150+($conf 


'rayon oeil']/4)); 


//ra 


yon 


return $drawing wand; 
} 









Naturellement, n'oubliez pas de rajouter les nouveaux parametres (la couleur de l'ceil, 
celle de l'iris et le rayon de l'oeil) dans le tableau $avatar du fichier avatar.php : 




Enfin, n'oublions pas, toujours dans le fichier avatar.php, d'utiliser notre nouvelle 
fonction : 

// utilisation des fonctions contenues dans 
// le fichier avatar fonctions .php : 

MagickDrawImage ( $magick wand, dessineTete ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineCheveux ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineOreille ($avatar) ) ; 
MagickDrawImage ( $magick wand, dessineYeuxEtNez ($avatar) ) ; 
MagickDrawImage ( $magick_wand, dessineBouche ($avatar ) ) ; 

Programmer un second nez et un second visage 

Nous pouvons deja avoir de nombreux avatars differents, mais ils auront finalement 
toujours la meme tete. Pour remedier a cela, nous allons programmer une seconde forme 
de nez ainsi qu'une seconde forme de visage de maniere a ce que Ton puisse choisir la 
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forme de notre choix directement depuis le tableau $avatar. Commen9ons done par lui 
ajouter quelques parametres : 



// tableau 


des parametres de 1' 


avatar 


$avatar = 


zirray ( 






' couleur 


peau' => 


"#d4c7a3", 




' couleur 


contour' 


=> "#000000 


if 


' opacite 


contour' 


=> 0.5, 




'epaisseur contour 


' => 3, 




' couleur 


cheveux' 


=> "#985d36 


ii 


' couleur 


oeil' => 


"#ffffff ", 




' couleur 


iris' => 


"Icccccc", 




'rayon oeil' => 16 


, 




'nez' => 


1, 






'tete' => 1, 
); 







Modifions maintenant la fonction DessineTeteQ de notre fichier avatar Jonctions.php : 

function dessineTete ($conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 

$pxl peau = NewPixelWand ( ) ; 

$pxl_contour = NewPixelWand () ; 

PixelSetColor ( $pxl_peau, $conf [ ' couleur_peau' ] ) ; 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 

DrawSetStrokeWidth ($drawing wand, $conf [' epaisseur contour']); 
DrawSetStrokeAlpha ($drawing wand, $conf [' opacite contour']); 

DrawSetFillColor ($drawing wand, $pxl peau); 
DrawSetStrokeColor ($drawing wand, $pxl contour); 

switch ($conf [' tete' ] ) { 
case 1 : 

DrawBezier ($drawing_wand, array ( 

42, 129,36, 141,40, 220, //points 1 a 3 
40, 220,70, 230,167, 194, //points 4 a 6 
167, 150167, 12651, 108, //points 7 a 9 

43, 129)); //bouclage 
break; 

default : 

DrawCircle ($drawing wand, 
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90, 150, 


//centre 


90, 205); 


//rayon 


break; 




} 




return $drawing wand; 
} 





Grace a l'instruction switch (), le script saura s'il lui faut dessiner une courbe de Bezier 
ou un cercle. Faisons de meme avec la fonction dessineYeuxEtNezQ : 

function dessineYeuxEtNez ( $conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 
$pxl oeil = NewPixelWand () ; 
$pxl iris = NewPixelWand () ; 
$pxl contour = NewPixelWand () ; 
$pxl peau = NewPixelWand () ; 

PixelSetColor ($pxl_oeil, $conf [ ' couleur_oeil' ] ) ; 
PixelSetColor ( $pxl iris, $conf [ ' couleur iris']); 
PixelSetColor ( $pxl contour, $conf [' couleur contour']); 
PixelSetColor ($pxl_peau, $conf [ ' couleur_peau' ] ) ; 

DrawSetStrokeWidth ($drawing wand, $conf [ ' epaisseur contour']); 
DrawSetStrokeAlpha ($drawing wand, $conf [ ' opacite contour']); 

// l'oeil droit : 

DrawSetFillColor ($drawing wand, $pxl oeil); 
DrawSetStrokeColor ($drawing wand, $pxl contour); 
DrawCircle ($drawing_wand, 

60, 150, //centre 

60, 150+$conf [' rayon_oeil' ] ) ; //rayon 

// l'iris droit : 

DrawSetFillColor ($drawing wand, $pxl iris); 

DrawCircle ($drawing_wand, 

63, 150, //centre 

60, 150+($conf ['rayon_oeil' ] /4) ) ; //rayon 

// le nez 

DrawSetFillColor ($drawing wand, $pxl peau) ; 
switch ($conf [' nez' ] ) { 
case 1 : 
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DrawBezier ($drawing wand, array ( 




75, 150,63, 159,75, 171,78, 


168) ); 


break; 




default : 




DrawBezier ($drawing wand, array ( 




72, 150,72, 150,42, 156,42, 


156, 


39, 159,36, 174,45, 174,45, 


174, 


78, 168,78, 168, 




break; 
} 
// l'oeil gauche : 






DrawSetFillColor ($drawing wand, $pxl oeil); 




DrawCircle ($drawing wand, 




90, 150, //centre 




90, 150+$conf [' rayon oeil']); //rayon 


// 1' iris gauche : 




DrawSetFillColor ($drawing wand, $pxl iris); 




DrawCircle ($drawing wand, 




93, 150, //centre 




93, 150+($conf [' rayon_oeil' ]/4) ) 


; //rayon 


return $drawing wand; 
} 





Ainsi, vous pouvez creer a loisir autant de formes d'yeux, de nez, de bouche, etc. 

Ecrire un nom au-dessus de notre avatar 

Pour en finir avec l'objet Drawi ngWand, nous allons voir comment ecrire quelque chose sur 
une image, avec la police de votre choix. 

Commencons done par completer notre tableau $avatar avec les parametres dont nous 
avons besoin pour le texte : 



$avatar = 


Array ( 






' couleur 


peau' = 


=> 


"#d4c7a3", 


' couleur 


contour 


, 


=> "#000000", 


' opacite 


contour 


, 


=> 0.5, 


'epaisseur contour 


' => 3, 


' couleur 


cheveux 


, 


=> "tcccccc", 


' couleur 


oeil' = 


=> 


"tffffff", 


' couleur 


iris' = 


=> 


"#50bb00", 


'rayon oeil' => 


10 


/ 


'nez' => 


2, 






'tete' = 


> 1, 






' fond ep 


aisseur 


contour' => 1, 
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'fond_couleur' => "#aaOOOO", 

' fond_couleur_contour' => "#000000' 

' nom' => "Maurice", 

'taille' => 35, 

'angle' => 10, 

'font' => 'Comic. ttf 



En ce qui concerne les polices de caracteres, n'oubliez pas de les copier dans le meme 
repertoire que le fichier qui les utilise, ou d'en indiquer correctement le chemin. 

Et voici, dans le fichier avatar _fonctions.php, le code de la fonction DessineNom() : 

function dessineNom ( $conf ) { 

// creer un objet DrawingWand 
$drawing wand = NewDrawingWand ( ) ; 

//creer des PixelWand 

$pxl_f ond_couleur = NewPixelWand () ; 

$pxl fond couleur contour = NewPixelWand () ; 

PixelSetColor ( $pxl fond couleur, 

$conf [ ' f ond_couleur' ] ) ; 
PixelSetColor ( $pxl fond couleur contour, 

$conf['fond couleur contour']); 

DrawSetStrokeWidth ($drawing wand, 

$conf [ ' f ond_epaisseur_contour' ] ) ; 

DrawSetFillColor ($drawing wand, $pxl fond couleur); 
DrawSetStrokeColor ($drawing wand, 

$pxl fond couleur contour) ; 

// la taille du texte en pixels : 

DrawSetFontSize ( $drawing wand, $conf [' taille' ]) ; 

// choix de la font : 

DrawSetFont ( $drawing wand, $conf [ ' f ont ' ] ) ; 

// changer 1' orientation du systeme de coordonnees : 

DrawRotate ($drawing_wand, $conf [' angle' ] ) ; 

// Cet objet MagickWand ne nous servira a rien d' autre 
// qu'a 1' utilisation des fonctions MagickGetStringWidth ( ) 
// et MagickGetStringHeight ( ) 
$magick_tmp = NewMagickWand ( ) ; 

// La fonction MagickGetStringWidth ( ) nous permet de savoir 

// quelle sera la largeur (en pixel) de la chaine de caracteres 
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// contenue dans $conf['nom'] : 

$largeurTexte = MagickGetStringWidth ( $magick tmp, 

$drawing wand, $conf [ ' nom' ] ) ; 
// Pareil, mais pour la hauteur de la chaine de caracteres 
$hauteurTexte = MagickGetStringheight ($magick tmp, 
$drawing wand, $conf [ ' nom' ] ) ; 

// Determiner les coordonnees de 
// notre chaine de caracteres : 
$posX = (180-$largeurTexte) 12; 
$posY = 10+$hauteurTexte; 

// Dessiner la chaine de caracteres : 
DrawAnnotation ($drawing wand, 

$posX, $posY, 

$conf [ ' nom' ] ) ; 



return $drawing_wand; 



} 



Pour terminer, voici quelques exemples d' avatars crees avec ce code 

► Fig. 3.17: 

Maurice 





Fig. 3.18: 

Hulk! 
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3.4 Check-list 

Dans ce chapitre, vous avez pu aborder la gestion des images et vous avez pu decouvrir 
qu'il est possible de generer des images a la volee. Nous avons vu : 

</ comment creer des images avec GD2 ; 

</ comment les redimensionner, les signer, les convertir ; 

*/ comment faire des montages et des incrustations ; 

«/ comment dessiner sur des images 

*/ comment appliquer des effets sur vos images avec ImageMagick et MagickWand ; 

«/ comment realiser des dessins complexes. 
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La classe FPDF permet de generer un document PDF 
grace a PHP. Ce document s'ouvrira dans le navigateur 
de I'utilisateur ou dans son lecteur PDF. Cette extension tres 
pratique vous permettra de creer dynamiquement des 
documents de toute nature, que I'utilisateur pourra 
conserver et diffuser independamment. 
FPDF est une classe libre, que vous pourrez utiliser dans 
vos projets commerciaux ou non. 
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4.1 Telecharger et utiliser FPDF 

Vous pouvez telecharger FPDF sur le site http://www.fpdf.org. A l'heure ou ces lignes sont 
ecrites, nous en sommes a la version 1.53. Creez un repertoire chap04, puis un repertoire 
fpdf a l'interieur. Et voila, FPDF est installe. 

Pour utiliser FPDF, il vous faudra, a chaque fichier l'utilisant, importer la classe FPDF : 

require ( ' fpdf /fpdf . php' ) ; 

Creer un document 

Tout au long de ce chapitre, nous allons travailler autour d'un seul petit programme, que 
nous ferons evoluer petit a petit. Ce petit programme aura pour but de generer un fichier 
PDF representant un releve de compte. Creez done, dans votre repertoire chap04, un 
nouveau fichier que vous appellerez fpdfjbanque.php, et completez-le de la maniere 
suivante : 

J^jt fpdf_banque.php 

<?php 

require ( ' fpdf /fpdf .php' ) ; 

//Creer une instance de FPDF 
$pdf=new FPDF () ; 

//Aj outer une page 
$pdf->AddPage ( ) ; 

//envoyer a la sortie standard 

$pdf->Output () ; 

?> 

Si vous lancez tout de suite ce fichier depuis votre navigateur favori, vous vous trouverez 
face a un splendide document PDF, en mode Portrait et au format A4, entierement vide. 
Vous vous en doutiez, ce n'est que le debut du chapitre... 

Vous pouvez remarquer que nous n'appelons pas la fonction header (), pour l'en-tete http. 
En effet, e'est FPDF qui s'en charge. 

Nous commencons par importer le contenu du fichier fpdf.php, e'est-a-dire le fichier 
contenant la classe FPDF que nous allons utiliser. 
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La creation d'un nouveau document 

Un document se cree tout simplement par l'appel du constructeur new FPDF(). C'est par 
cet appel que nous definissons les dimensions de notre document, son unite de mesure de 
base, ou son orientation (Portrait ou Paysage). Le constructeur dispose de trois parametres, 
facultatifs, qui vont vous permettre de creer le nouveau document de vos reves : 

FPDF([chaTne $orientation (, chaTne $unite [, mixe $dimension]]]) 

Le premier parametre du constructeur, $orientation, deflnit 1' orientation de vos pages. 
Non renseigne, votre document prendra l'orientation Portrait par defaut. Cette chaine de 
caracteres peut prendre les valeurs suivantes : 



1 P ' : portrait ; 



1 L ' : paysage {landscape). 

Le deuxieme parametre, $unite, deflnit l'unite de notre systeme de coordonnees. L'unite 
par defaut est le millimetre, mais vous pouvez aussi choisir une autre unite parmi les 
suivantes : 

I ' pt ' : point (il faut 72 points alignes pour faire une ligne de 1 pouce, soit 2,54 cm) ; 
'mm' : millimetre ; 
1 cm ' : centimetre ; 
'in': pouce. 

Le dernier parametre, $dimension, vous permet de specifier les dimensions de votre 
document. Vous pouvez le renseigner avec un tableau contenant des nombres flottants 
representant la largeur et la hauteur dudit document. Ces nombres seront interpreted avec 
1' unite que vous avez choisie. Vous pouvez aussi renseigner ce parametre avec une des 
chaines de caracteres suivantes : 

'A3' 
'A4' 
■A5 1 

'Letter' ; 
'Legal'. 

Faire sortir son document 

Regardons maintenant la fonction Output (). Sans aucun parametre, elle se contente de 
renvoyer notre document sur la sortie standard c'est-a-dire, le plus souvent, le navigateur. 
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Cette fonction dispose de deux parametres, nous permettant de donner un nom au fichier, 
puis de savoir si on l'enregistre localement ou si on l'envoie sur le navigateur de 
l'utilisateur, ou encore si on lui propose de telecharger le document. 

Le premier parametre est une chaine de caracteres donnant un nom de fichier a notre 
document. Modifiez votre code comme ceci : 

$pdf->Output ("fichier.pdf") ; 

Si vous executez votre fichier, rien n'apparaitra dans le navigateur. Le plug-in 
Acrobat Reader ne se lancera meme pas. Par contre, votre document aura ete enregistre 
sur votre disque, sous le nomfichier.pdf. Vous pouvez influer sur cette action en specifiant 
le deuxieme parametre. II s'agit d'une chaine de caracteres pouvant prendre les valeurs 
suivantes : 

1 1 ' : envoie au navigateur. Si l'utilisateur decide d'enregistrer le document sur son 
disque, le nom propose sera celui que vous aviez indique avec le premier parametre. 
1 D ' : propose le fichier en telechargement a l'utilisateur. 

1 F ' : enregistre le fichier localement, avec le nom propose par le premier argument. 
1 S ' : renvoie le document sous la forme d'une chaine de caracteres. 

Si aucun parametre n'est renseigne, la fonction envoie le document au navigateur. Si seul 
le deuxieme parametre est omis, la fonction enregistre le fichier localement. 

Pour continuer ce chapitre et faire en sorte que votre document apparaisse dans votre 
navigateur, il vous faut modifier a nouveau votre fichier en enlevant 1' argument que vous 
venez d'ajouter a la fonction Output (). 

Placer des images 

A present, il est temps de commencer a remplir notre document. Traditionnellement, nous 
vous ferions ecrire une petite phrase, mais placer une image est tellement simple que c'est 
ce que nous allons faire. Juste apres l'appel a la fonction AddPageQ de votre fichier 
fpdfjbanque.php, ajoutez la ligne suivante : 

//Poser une image : 

$pdf->Image (' redf ish .png' , 5, 5, 50); 

Voici la fonction ImageQ. Concretement, elle va afficher 1' image passee au premier 
argument dans notre document. Elle placera le coin superieur gauche de notre image au 
point de coordonnees (5, 5), et dimensionnera sans la deformer (en respectant 
l'homothetie) notre image de maniere a ce qu'elle fasse 50 unites (dans notre exemple, 
l'unite est le millimetre) de large. La hauteur de l'image sera adaptee. 
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(j) Le systeme de coordonnees 

Avec FPDF, I'origine de notre systeme de coordonnees se trouve dans le coin superieur gauche de la 
page PDF. 

Les types d'images que vous pouvez utiliser sont le JPEG et le PNG. 
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Fig. 4.1 : Notre image 

Placer du texte 

Nous allons, avant de commencer a ecrire du texte sur notre document PDF, creer un 
nouveau fichier appele fpdf_donnees.php. Ce fichier contiendra toutes les donnees que 
nous inscrirons dans notre document PDF. Le fait qu'il soit separe de fpdfjbanque.php 
nous permettra de changer ces donnees plus facilement. Voici done la premiere de nos 
donnees, a mettre dans le fichier fpdf_donnees.php : 



<?php 






$titre = 


= "RELEVE DE COMPTE" ; 




?> 
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N'oubliez pas de preciser, dans fpdfjbanque.php, que nous allons utiliser des donnees 
provenant d'un autre fichier : 

<?php 

require ( ' fpdf /fpdf . php' ) ; 

include 'fpdf donnees .php' ; 



A present, nous allons ecrire le premier texte dans notre document. Toujours dans le 
fichier fpdf '_banque.php, inserez les lignes suivantes juste apres l'appel de l'image : 

//Ecrire une chaine 
$pdf->SetFont ('Arial' , 'B' , 16) ; 
$largeur = $pdf->GetStringWidth ( $titre) ; 
$pdf->SetX(105- ($largeur/2) ) ; 
$pdf->Cell ($largeur, 0, $titre); 

Si vous lancez ce fichier maintenant, vous allez voir votre titre apparaitre. 
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RELEVE DE COMPTE 



Fig. 4.2 : Votre premier texte 
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Definir la police de caracteres 

Mais que se cache-t-il, dans ces quatre lignes de code ? Tout d'abord, nous definissons la 
police de caracteres courante grace a la fonction Set Font (). Le premier des trois 
arguments de cette fonction precise, d'une chaine de caracteres, quelle famille de police 
utiliser. Les families disponibles sont les suivantes : 

1 ' : chaine vide : aucune police, ou bien conserve la police precedente. 

'Courier' 

'Arial ' 

'Helvetica' 

'Times' 

' Symbol ' 

'Zapf Dingbats' 

Le deuxieme parametre indique le style de la police. II peut prendre les valeurs suivantes : 

' ' : chaine vide : style normal. 

' B ' : votre texte sera ecrit en gras. 

' I ' : votre texte sera ecrit en italique. 

' U ' : votre texte sera souligne. 

Vous pouvez aussi ecrire ' BIU ' , votre texte sera en gras italique souligne. Ou alors 

'UB', votre texte sera ecrit en gras et souligne... 

Enfm, le troisieme parametre indique la taille de la police, en point. Dans notre exemple, 
et ce jusqu'au prochain appel de la fonction SetFontQ, nos textes seront ecrits en Arial, 
gras, et auront une taille de 16 pt. 

Positionner une chaine : connaitre sa largeur 

Comme nous souhaitons centrer notre titre, et qu'il n'existe pas vraiment de fonction faite 
specialement pour cela, il nous faut savoir quelle est la largeur de notre chaine de 
caracteres $titre, lorsqu'elle est ecrite en Arial, gras, et avec une taille de 16 pt. C'est 
tout simplement ce que se propose de faire la fonction GetStringWidth(). Nous 
recuperons le resultat qu'elle nous renvoie dans la variable $largeur. 

Nous allons utiliser la fonction SetX() pour defmir le point de coordonnees courant, 
c'est-a-dire le point a partir duquel nous allons ecrire, dessiner, ou placer une image. Ce 
n'est pas la peine d'utiliser la fonction SetY() (ou la fonction SetXYQ), car le point de 
coordonnees courant est deja verticalement defini en accord avec nos souhaits. 
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Ecrire le texte 

Nous avons determine notre police de caracteres ainsi que l'emplacement de notre texte. 
II ne nous reste plus qu'a l'ecrire. A cet effet, nous utilisons la fonction Cell (). Voici 
comment nous 1' avons mise en scene : 

$pdf->Cell ($largeur, 0, $titre); 

En fait, notre texte va se placer a l'interieur d'une cellule. Le premier argument de cette 
fonction definit done la largeur de cette cellule, et le deuxieme sa hauteur. Une hauteur 
de mm n'est, pour le moment, pas encore un probleme. Le troisieme argument est, bien 
sur, la chaine de caracteres a ecrire sur le document. 

Ecrivons une deuxieme chaine. Commencez par creer, dans votre fichier fpdf_donnes.php, 
la variable $dateReleve contenant la chaine de caracteres que nous allons afficher. 
Ensuite, ajoutez ces lignes dans fpdfjbanque.php : 

//Ecrire une chaine 

$pdf->SetFont ('Arial' , ' I' , 12) ; 

$largeur = $pdf->GetStringWidth ($dateReleve) ; 

$pdf->SetXY(105, 10); 

$pdf->Cell ($largeur, 10, $dateReleve) ; 
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Fig. 4.3 : Un deuxieme texte ! Mais jusqu'ou ira-t-on ? 
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Ecrire des blocs de texte 

Pour le moment, nous n'avons ecrit du texte que sous forme de lignes, mais il est possible 
de le faire sous forme de paragraphes : les blocs de texte. Nous allons done creer, dans fpdf_ 
donnees.php, une variable $adresse contenant une chaine de caracteres suffisamment longue 
pour pouvoir constituer un paragraphe. Voici celle que nous utilisons dans notre exemple : 

$adresse = "M. Moutarde Colonel, \n Chez le Dr. Lenoir\n"; 
$adresse .= "25 rue de la Salle de Billard\n"; 
$adresse .= "14320 Avec-Le-Chandelier" ; 

Vous pouvez noter la presence, dans notre chaine, du caractere de retour chariot ' \n ' , afin 
de signifier les endroits ou nous demandons explicitement a retourner a la ligne. 

Ajoutons maintenant, dans fpdfjbanque.php, de quoi constituer notre paragraphe : 



//Ecrire un paragraphe 






$pdf- 


->SetXY(105, 30); 






$pdf- 


->SetFont ('Courier' 


r r 
i 


12) ; 


$pdf- 


->Multicell (80, 5, 


$ad 


resse) ; 



Et voila. II n'y a rien de complique, si ce n'est que nous utilisons la fonction Mul ti eel 1 () 
au lieu de Cell (). 




Fig. 4.4 : Un bloc de texte 
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Q) La hauteur de la cellule 

Un bloc de texte est fait de plusieurs cellules a la suite. II est done important de specifier une hauteur 
pour ces cellules. Si vous laissez le deuxieme parametre de la fonction MulticellO a 0, toutes vos 
lignes s'ecriront les unes par-dessus les autres. En somme, la hauteur de la cellule est ce qui sert de 
reference a FPDF pour savoir ou placer une ligne (cellule) par rapport a la ligne precedente. 



Centrer, justifier ou aligner sur la droite le contenu d'un bloc de texte 

Eh oui, la fonction Multicell () est assez complete ! En plus, cela se fait simplement. 

Comme nous avons besoin d'une nouvelle chaine de caracteres pour le nouveau 
paragraphe que nous allons faire, nous vous laissons le soin d'en creer une dans le fichier 
fpdf_donnees.php (dans une variable $parCentre). Voici celle que nous utilisons dans 
notre exemple : 

OparCentre = "La banque \"RedFish\" - la banque a qui on " ; 

$parCentre .= "fait confiance - est tres tres fiere, "; 

$parCentre .= "de vous presenter son "; 

$parCentre .= "nouveau service de releves de comptes " ; 

$parCentre .= "en ligne !\n***\nUn service entierement " ; 

$parCentre .= "dynamique qui nous permet de vous faire " ; 

$parCentre .= "des releves de comptes quand vous le " ; 

$parCentre .= "souhaitez, et couvrant la periode de "; 

$parCentre .= "votre choix ! \nTrop chouette, hein ?! ! " ; 

Voyons maintenant le code a ajouter a fpdfjbanque.php : 

//Ecrire un paragraphe centre 
$pdf->SetXY(45, 60); 
$pdf->SetFont ('Arial' , " , 10) ; 
$pdf->Multicell (120, 5, 

utf 8_decode ($parCentre) , 

0, 'C'); 

Comme vous pouvez le constater, nous avons rajoute deux arguments a la fonction 
Mul ti eel 1 () . Celui qui vaut (1' avant-dernier argument) signifie que nous ne voulons pas 
de cadre a notre paragraphe (nous parlerons des cadres un peu plus loin). Le dernier 
parametre est en fait une chaine de caracteres qui indique comment aligner le texte de 
votre paragraphe. Cette chaine peut prendre les valeurs suivantes : 

1 L ' : votre paragraphe est aligne a gauche. 
1 R ' : votre paragraphe est aligne a droite. 
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1 C ' : pour centrer le texte du paragraphe. 
1 J ' : pour justifier le texte du paragraphe. 
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RELEVEDE COMPTE 

Du 19/09/2007 au 1S/10/2007 



M. Moutarde Colonel, 
Chez le Dr. Lenoir 
2 5 rue de la Salle de Billard 
1432 Avec-Le-Chandelier 



La banque "RedFish" - la banque a qui on fait confiance - est tres tres fiere, 
de vous presenter son nouveau service de releves de comptes en ligne ! 

Un service entierement dyn antique qui nous permet de vojs faire des 

releves de comptes quand vous le souhaitez, et couvrant fa periode de 

votre choix 

Trap super chouette, hein ?!l 



Fig. 4.5 : Un paragraphe ou le texte est centre. 

Des lignes et des colonnes : faire un tableau 

Nous allons examiner un peu plus en detail ce que Ton peut faire avec une cellule. Pour 
le moment, notre point de coordonnees courant se trouve a la fm du paragraphe que nous 
venons d'ecrire. Nous allons commencer par effectuer un retour chariot (sauter une ligne), 
de maniere a ce que notre point de coordonnees courant se trouve une ligne en dessous 
de notre paragraphe, et le long de la marge de gauche (c'est-a-dire a 1 cm du bord 
gauche). 
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Q) Les marges 

II existe une marge de 1 cm de cote, le long des quatre bords de notre page. Lorsque le point de 
coordonnees courant est deplace automatiquement, il prend en compte la marge pour definir sa 
nouvelle position. Lorsque vous utilisez les fonctions SetX(), SetY() ouSetXY() pour changer le point de 
coordonnees courant, vous pouvez passer outre les marges (et c'est d'ailleurs ce que nous avons fait 
lorsque nous avons place notre image). 

Ajoutez la ligne suivante a la suite de fpdf_banque.php : 

//sauter une ligne 
$pdf->Ln (4) ; 

La fonction Ln ( ) effectue un retour chariot. Le parametre determine la hauteur de la ligne 
a sauter (ici, 4 mm. Attention : si 1' unite que vous avez choisie est le point, notre ligne 
ne fera pas 4 mm de hauteur, mais 4 pt). Si on ne precise pas la hauteur de la ligne a 
sauter, celle-ci prendra automatiquement pour valeur la hauteur de la ligne precedente. 

Ann de realiser notre tableau, nous allons entrer de nouvelles donnees dans le fichier 
fpdf_donnees.php : 



$ancienSolde 


= 100; 








$operation = 


array ( 








array ( 










'date' = 


> "19/09", 








' nature' 


=> 'Cotisa 


tion 


mensuelle' , 


'debit' 


=> 10 








) i 

array ( 










'date' = 


> "20/09", 








' nature' 


=> 'Carte 


bl 


eue 


' 


'debit' 


=> 32.5 








1 r 

array ( 










'date' = 


> "20/09", 








' nature' 


=> ' Commerce 


el 


ectronique' , 


'debit' 


=> 2 6.10 








array ( 










'date' = 


> "21/09", 








' nature' 


=> ' Trouve 


P 


ar 


terre' , 


' credit' 
) , 
); 


=> 50 
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La moindre des choses sur un releve de compte, avant meme de commencer le tableau des 
operations, c'est de rappeler a l'usager le solde restant sur son compte. Rajoutons done 
ces quelques lignes dans notre fichier fpdfjbanque.php : 

$soldePrecedent = "Solde precedent : " . $ancienSolde; 

$pdf->SetFont ('Arial' , 'B' , 12) ; 

$pdf->Cell (100, 0, utf8_decode ($soldePrecedent) ) ; 

Attaquons-nous a la premiere ligne de notre tableau : les en-tetes de colonnes. Ajoutez le 
code suivant a fpdfjbanque.php : 



//saut de ligne 




$pdf->Ln(4) ; 




// Un tableau 




//Les en-tetes 




$pdf ->SetLineWidth (0.4); 




$pdf->SetX(10) ; 




$pdf->Cell(15, 5, 'Date', 1, 0, 'C'); 




$pdf->Cell(115, 5, 




utf8 decode ( 'Nature de IV operation' ) , 




1, 0, 'C'); 




$pdf->Cell (30, 5, utf8 decode (' Debit' ) , 




1, 0, 'C'); 




$pdf->Cell (30, 5, utf8 decode (' Credit' ) , 




1, 0, 'C'); 





Tout d'abord, nous appelons la fonction SetLineWidth(), qui nous permet de choisir une 
epaisseur pour nos traits. Ensuite, nous appelons la fonction SetX(), arm d'etre sur de la 
position du point de coordonnees courant. C'est seulement apres que nous commencons 
a placer les cellules. Nous pouvons deja voir que nous ne touchons pas au point de 
coordonnees courant : des qu'il a fini une cellule, il se positionne automatiquement a la 
suite de celle-ci, pret a en demarrer une autre ! 

Dernier petit detail : le quatrieme parametre est a 1 , ce qui signifle que chaque cellule va 
se retrouver habillee par une bordure de 1' epaisseur precisee par la fonction 
SetLineWidth(). Regardez done votre travail depuis votre navigateur prefere. 
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RELEVE DE COMPTE 

Du 19/09/2007 au 13/10/2007 



M. Moutarde Colonel, 
Chez le Dr. Lenoir 
25 rue de la Salle de Billard 
14320 Avec-Le-Chandeller 



La barque "RedFish" - la banque a qui on fait confiance - est tres tres fiere, 
de vous presenter son nouveau service de releves de comptes en ligne ! 

Un service entierement dynamique qui nous perrnet de vous faire des 

releves de comptes quand vous le souhaitez, et couvrant la periode de 

votrechoix I 

Trap super chouette, hein ?! 



Solde precedent : 100 



Date 



Nature de opsration 



Debit 



Credit 



► Fig. 4.6 : Des cellules encadrees 

Les lignes du tableau 

Nous avons, dans le fichier fpdf_donnees.php, cree la variable $operation, qui est en fait 
un tableau contenant toutes les operations que nous allons lister maintenant. Voici le code 
a aj outer au fichier fpdfjbanque.php : 



//les lignes 




$pdf->SetFont ('Arial' , " , 12) ; 




$pdf->SetFillColor (230, 230, 230); 




$mouvementDebit = ; 




$mouvementCredit = 0; 




for($i = ; $i < count ($operation) 


; $i++) { 


$pdf->Ln ( ) ; 
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//definit s'il faut remplir cette ligne 
//avec la couleur de remplissage ou non . 
$ remplir = ; 
if ($i % 2 != 0) { 

$remplir = 1 ; 
} 

//Cellule 'Date' 

$pdf->Cell (15, 5, $operation[$i] ['date' ] , 'L', 0, ' C , $remplir) ; 
//Cellule 'Nature' 

$pdf->Cell (115, 5, utf8_decode ($operation [$i] ['nature' ]) , 'L', 0, 'L', 
*» $remplir) ; 
//Cellule 'Debit' 

$pdf->Cell (30, 5, utf8_decode ($operation [$i] ['debit' ]) , 'L', 0, 'R', 
*» $remplir) ; 

$mouvementDebit += $operation [$i] ['debit']; 
//Cellule 'Credit' 

$pdf->Cell (30, 5, utf8_decode($operation[$i] ['credit' ]) , ' LR' , 0, ' R' , 
**■ $ remplir) ; 

$mouvementCredit += $operation [$i] [' credit' ] ; 
} 

La fonction SetFi llColor() que nous utilisons ici permet de definir la couleur de 
remplissage par defaut. Les parametres sont des nombres compris entre et 255 et servent 
a definir la proportion de couleur pour chacune des trois composantes de la lumiere. Le 
premier parametre decrit la composante rouge, le deuxieme la composante verte, et le 
troisieme la composante bleue. 

Le reste du code se passe dans la boucle for : nous commencons par sauter une ligne 
(fonction Ln ( ) ) puis, grace a un petit test if, nous determinons si le numero de la ligne 
est pair ou impair. Cela nous sera utile pour colorer le fond d'une ligne sur deux. 

Viennent alors les cellules en elles-memes. Nous observons tout d'abord que le quatrieme 
parametre de la fonction Cel 1 (), celui qui sert a mettre ou non la bordure, n'est plus un 
entier, mais une chaine de caracteres. Voici les differentes valeurs que peut prendre ce 
quatrieme parametre : 

: pas de bordure. 

1 : la bordure est presente. 
(comme left) seulement la bordure droite de notre cellule, 
(comme top) seulement la bordure superieure de notre cellule, 
(comme right) seulement la bordure droite de notre cellule. 



'L' 
T 

I D ' 



R' 
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1 B ' : (comme bottom) seulement la bordure inferieure de notre cellule. 
Vous pouvez aussi utiliser plusieurs de ces lettres. Par exemple, la chaine ' LR ' (ou 
la chaine ' RL ' , l'ordre n'a pas d'importance) fera apparaitre la bordure sur les cotes 
gauche et droit de notre cellule. 

Enfin, un dernier parametre a fait son apparition au sein de la fonction Cel 1 (). Parametre 
a 1 ou a 0, il definit si oui (1) ou non (0) la cellule doit etre remplie avec la couleur de 
remplissage courante ; ce qui nous permet d'alterner les lignes colorees avec celles non 
colorees. 
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RELEVEDE COMPTE 

Du 19/09/2007 an 18/10/2007 



M . Houtarde Colonel , 
Chez le Dr. Lenoir 
2 5 rue de la Salle de Billard 
14320 Avee-Le-Chandelier 



La barque "RedFish" - la barque a qui on fait confiance - est tres tres fiere, 
de vous presenter son nouveau service de releves de comptes en ligne I 

Un service entierement dynamique qui nous permet de vous faire des 
releves de comptes quand vous le souhaitez, et couvrant la periode de 

votre choix I 
Trap super chouette, hein ?!! 



Solde precedent : 100 



Date 


Nature de I'operation 


Debit 


Credit 


19/09 


Cotisation mensuelle 


10 




20/09 


Carte Bleue 


32.5 




20/09 


Commerce electronique 


261 




21/09 


Trouve parterre 




50 



Fig. 4.7 : Les lignes du tableai 



IBS 



Telecharger et utiliser FPDF 



Finir le tableau 

Nous avons pratiquement termine le tableau. D'ailleurs, avec les connaissances que vous 
avez acquises, vous devriez etre capable de terminer tout seul ce tableau. Voici neanmoins 
comment nous nous y prenons : 

//Derniere ligne 

$pdf->SetFont ('Arial' , 'B' , 12) ; 

$pdf->Ln ( ) ; 

$rempli = 0; 

if (count ($operation) % 2 != 0){ 

$rempli = 1 ; 
} 

//Cellule 'Date' 

$pdf->Cell(15, 5, ", 'LB', 0, 'C, $rempli); 
//Cellule 'Nature' 
$repere = $pdf->GetX ( ) ; 

$pdf->Cell (115, 5, 'TOTAUX DES MOUVEMENTS', 'LB', 0, ' R' , $rempli); 
//Cellule 'Debit' 

$pdf->Cell (30, 5, $mouvementDebit, 'LB', 0, 'R', $rempli) ; 
//Cellule 'Debit' 
$pdf->Cell (30, 5, $mouvementCredit, ' LBR' , 0, 'R', $rempli) ; 

//ligne "nouveau solde" 

$pdf->Ln ( ) ; 

$pdf->SetX ($repere) ; 

$pdf->Cell (115, 5, 'NOUVEAU SOLDE', 0, 0, ' R' ) ; 

//calcul du nouveau solde 

$nouveauSolde = $mouvementCredit-$mouvementDebit+$ancienSolde; 

$celluleDebit = ' ' ; 

$celluleCredit = " ; 

if ($nouveauSolde < 0){ 

$celluleDebit .= $nouveauSolde; 
} else { 

$celluleCredit .= $nouveauSolde; 
} 

$pdf->Cell (30, 5, $celluleDebit, 0, 0, ' R' ) ; 
$pdf->Cell (30, 5, $celluleCredit, 0, 0, 'R'); 

Comme vous pouvez le constater, nous avons deja utilise et explique toutes les fonctions 
presentes dans ce bout de code. Admirez done le resultat de votre travail. Et profitez-en 
pour le personnaliser ou le peaufiner. 
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RELEVEDE COMPTE 

Du 79/09/2007 au 73/70/2007 



M. Houtarde Colonel , 
Chez le Dr. Lenoir 
2 5 rue de la Salle de Billard 
14320 Avec-Le-Chandelier 



La barque "RedFish" - la banque a qui on fait confiance - est tres tres fieire, 
de vous presenter son nouveau service de releves de comptes en ligne ! 

Un service entierement dynamique qui nous permet de vous faire des 

releves de comptes quand vous le souhaitez : et couvrant Ea periode de 

votre choix I 

Trap super chouette, hein ?!! 



Solde precedent : 100 






Date 


Nature de I'operation 


Debit 


Credit 


19/08 


Cotisation mensuelle 


10 




20/09 


Carte Bleue 


32.5 




20/09 


Commerce electronique 


261 




21/09 


Trouve parterre 




50 




TOTAUX DES MOUVEMENTS 


€3.3 


50 



NOUVEAU SOLDE 



81.4 



Fig. 4.8 : Notre tableau estfini 



4.2 A propos des pages 

Un document PDF peut etre compose d'une ou plusieurs pages. Nous avons deja vu la 
fonction AddPage() (au tout debut de ce chapitre), qui nous permet justement de rajouter 
une page. II existe cependant un moyen de rajouter une page implicitement. 

Dans votre fichier fpdf_donnees.php, veuillez ajouter une quinzaine d' entrees au tableau 
$operation, puis relancez le fichier fpdfjbanque.php dans votre navigateur. 
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Carte Bleue 

Commerce etectronique 
Trouve parterre 
Mange dehors 
Perdu dans la rue 
Cotisntki- iTsnsuelle 
Carte Bleue 



32.5 

26_1 



15 

10 
325 



20/09 


Commerce etectronique 


261 




21/09 


Trouve parterre 




50 


22/09 


Mange dehors 


15 




23/09 


Perdu dans \a rue 


15 






TOTAUX DES MOUVEMENTS 


591.6 


300 



NOUVEAU SOLDE 



Fig. 4.9 : Creation d'une page automatique 

Comme vous le constatez, notre tableau est a present trop grand pour ne tenir que sur la 
premiere page. FPDF va done creer une seconde page. II en sera de meme pour un bloc 
de texte. 

Un petit peu de dessin 

Comme tous les logiciels generant du PDF, FPDF dispose de quelques fonctions de 
dessins, que nous allons examiner. A la toute fin de votre fichier fpdfjbanque.php (avant 
l'appel a la fonction Output ()), ajoutez le code suivant : 



//Aj outer une page 






$pdf->AddPage ( ) ; 






$pdf->SetDrawColor (100, 


100, 


100) ; 


//dessiner un rectangle 






$pdf->Rect (10, 10, 190, 


277, 


' DF' ) ; 


//dessiner une ligne 






$pdf ->SetLineWidth ( 1 ) ; 






$pdf->Line(20, 20, 190, 


277) 
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Nous commencons par utiliser la fonction SetDrawColorQ, dont le but est d'allouer une 
couleur de trace courante. Elle s'utilise avec les trois composantes couleurs de la lumiere 
(rouge, verte et bleue), exactement comme son homologue Set Fi 1 1 Col or () . 

Nous utilisons ensuite la fonction Rect() qui dessine un rectangle. Dans notre exemple, 
le coin superieur gauche du rectangle est place au point de coordonnees (10, 10), comme 
l'indiquent les deux premiers arguments. Notre rectangle fait aussi 190 mm de largeur 
(troisieme argument) sur 277 de hauteur (quatrieme parametre). Le dernier parametre 
indique comment colorer notre rectangle. II peut prendre les valeurs suivantes : 

1 D ' ou " (chaine vide) : dessine seulement le contour du rectangle (utilise la couleur 
de trace courante). 

1 F ' : remplit le rectangle avec la couleur de remplissage courante, mais ne dessine 
pas son contour. 
I ' DF ' ou ' FD ' : remplit le rectangle avec la couleur de remplissage courante, et 
dessine son contour avec la couleur de trace courante. 

Enfin, nous appelons la fonction Line() qui, comme son nom l'indique, trace une ligne avec 
la couleur de trace courante. Les deux premiers arguments de cette fonction definissent les 
coordonnees du point de depart de notre ligne, et les deux derniers, le point d'arrivee. 




Fig. 4.10: Un rectangle et un trait 
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Nous avons fait le tour des fonctions de dessins de FPDF. Comme vous avez pu le 
constater, il existe seulement deux fonctions pour dessiner, ce qui est effectivement tres 
limite. Mais PDF n'a pas ete concu pour dessiner. Et puis, rien ne vous empeche de 
concevoir des images et des graphiques avec GD2 ou MagickWand, pour etayer ensuite 
vos documents PDF 

Vous pouvez vous referer au chapitre Manipuler des images pour plus de details 
sur Vutilisation de MagickWand ou de GDI. 

En-tetes et pieds de page 

II existe, dans FPDF, deux fonctions qui sont appelees a chaque creation de page. II s'agit 
des fonctions HeaderQ et Footer(). Enfin, elles existent, mais... elles sont vides. 

En fait, nous avons la possibilite de surcharger ces fonctions, de maniere a etablir un 
en-tete et un pied de page en accord avec votre document, son nombre de pages, etc. 

Comme il nous faut surcharger ces deux fonctions, nous allons creer une classe derivant 
de FPDF dans un nouveau fichier, fpdf_classe.php, que voici : 

<^jt fpdf_classe.php 

<?php 

require ( ' fpdf/fpdf .php' ) ; 

class PDF extends FPDF{ 
//En-tete 
function Header (){ 

$this->SetFont ('Arial' , 'I' , 8) ; 
$this->SetXY(2.5, 2.5); 
$this->Cell (30,0, ' Banque RedFish' ) ; 
$this->SetXY(10, 10); 
} 

//Pied de page 
function Footer (){ 

//Positionnement a 10mm du bas 

$this->SetXY(5, -10); 

$this->SetFont ('Arial' , 'I' , 8) ; 

//Numero de page 

$this->Cell (0, 10, 'Page ' . $this->PageNo ( ) . ' / {nb } ' , 0, 0, ' C ) ; 
} 
} 
?> 
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Rien de difficile : nous nous contentons de deriver la classe FPDF en une nouvelle classe 
appelee PDF, puis nous redefinissons simplement les fonctions Header () et Footer (). 
Ainsi, nous precisons dans la fonction Header () que nous voulons un texte ecrit en Arial, 
italique, 8 pt, que nous placons au point de coordonnees (2.5, 2.5). 

/!\ Faites attention a vos unites 

Notre unite de mesure, dans fpdf_banque.php, est le mm. Ainsi, lorsque nous placons nos elements 
dans les fonctions Header() et FooterQ, c'est le millimetre qui est utilise. Si d'aventure, vous souhaitez 
travailler avec des pouces, n'oubliez pas de convertir les valeurs de ces deux fonctions. 

Nous utilisons ici, dans ce petit bout de classe, une nouvelle fonction : PageNoQ. Cette 
fonction renverra le numero de la page courante (si nous sommes sur la premiere page, 
elle renverra 1, si nous sommes sur la deuxieme, elle renverra 2, etc.). Cette fonction est 
a utiliser de concert avec la petite chaine de caracteres {nb}, qui renvoie toujours le 
nombre de pages du document. 

Avant de proceder a un test, il reste des modifications a effectuer dans le fichier 
fpdfjbanque.php. Nous allons effectivement changer les premieres lignes de ce 
programme : 



<?php 






//require (' f pelf /f pdf 


php' ) ; 


include 


' fpdf donnees . php' ; 


include 


' fpdf classe 


php' ; 


//Creer 


une instance 


de FPDF 


//$pdf=new FPDF () ; 




$pdf = 


lew PDF () ; 




$pdf->AliasNbPages () ; 





Le fichier fpdf. php n'est plus requis, puisque nous utilisons la classe PDF, contenue dans 
le fichier fpdf_classe.php, qu'il ne nous faut pas oublier d'inclure. Le constructeur aussi 
change : nous n'utilisons plus FPDF() mais PDF(). 

Juste apres le constructeur, nous appelons une nouvelle fonction : AliasNbPagesQ. Cette 
fonction n'a rien d'exceptionnel ou de remarquable. Simplement, si Ton veut utiliser la 
fonction PageNoQ dans notre en-tete ou dans notre pied de page, il nous faut appeler cette 
fonction. Et pas n'importe ou : seulement entre l'appel du constructeur et l'ajout de la 
premiere page ! 
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Fig. 4.1 1 : Le footer 

4.3 Importer une police de caracteres 

Utiliser seulement les quelques polices de caracteres parmi les plus classiques lors de la 
creation d'un document PDF est assez ennuyeux. Heureusement, FPDF nous permet 
d' avoir recours a des polices TrueType. Attention, la demarche est assez fastidieuse. 

Premiere etape : generer un fichier de metrique 

Bien evidemment, nous n'allons pas utiliser de police TrueType en trois lignes de code. 

Allez done chercher une petite archive zip contenant un utilitaire a l'adresse 
suivante : http://www.fpdf.org/fr/dl.php7id =33. 

Creez ensuite, a la racine de votre disque dur C :, un repertoire que vous nommerez 
ttfi.pt 1. Decompressez votre archive dans ce repertoire. Vous devriez avoir deux fichiers : 
ttfiptl.exe et COPYRIGHT. Copiez ensuite, toujours dans le repertoire C:\ttfiptl, un 
fichier de police TrueType. Dans notre exemple, nous allons utiliser le fichier comic.ttf. 

C'est maintenant que les barbarismes commencent. Ouvrez une nouvelle fenetre d'Invite 
de commandes (menu Demarrer puis Executer. Tapez ensuite and dans la fenetre qui 
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est apparue, puis cliquez sur OK). Naviguez jusqu'a rejoindre votre repertoire c:\ttf2ptl, 
puis entrez la commande suivante : 

ttf2ptl -a comic. ttf comic 

Ici, comic.ttf est le nom du fichier de police, et comic est le nom de la police auquel nous 
nous refererons lorsque nous souhaiterons l'utiliser au sein de FPDF. 




Fig. 4. 1 2 : Pour generer un fichier de metrique. . . 

Regardez maintenant le contenu de votre repertoire C:\ttf2ptl : les fichiers comic.afm et 
comic.tla sont bel et bien presents. 

Deuxieme etape : generer le fichier de definition de police 

Regardez le contenu de votre repertoire chap04\fpdffont : ici, des fichiers PHP sont 
stockes. Chacun d'entre eux sert a definir une des polices que FPDF peut utiliser. Vous 
les reconnaissez d'ailleurs a leurs noms tres explicites : courier.php, helvetica.php... 
Notre but est maintenant de rajouter le fichier comic.php. 

Dans votre repertoire chap04, creez encore un nouveau repertoire que vous nommerez 
font. Copiez dans ce repertoire les fichiers comic. ttf et comic.afm (le fichier que nous 
venons de generer avec l'utilitaire ttflptl). Toujours dans ce meme repertoire, creez le 
fichier PHP fpdf_export_police.php et remplissez-le comme suit : 

<^jt fpdf_export_font.php 

<?php 

require ( ' . . /fpdf / font /make font /make font . php' ) ; 

MakeFont ( ' comic. ttf ' , ' comic . afm' , ' cpl252' ) ; 

?> 
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Nous utilisons ici la fonction MakeFont(), issue du fichier makefont.php (ce fichier fait 
partie de 1' archive FPDF que vous avez telechargee au debut de ce chapitre). 

Le premier parametre de cette fonction indique le fichier TrueType. II sera integre au 
fichier PDF. Si toutefois vous ne souhaitez pas l'integrer, car vous pensez que ce fichier 
TrueType est present sur la machine de l'utilisateur, ou que vous ne voulez pas augmenter 
le poids du fichier PDF que vous allez generer, ou pour toute autre raison, vous pouvez 
laisser une chaine vide. 

Le deuxieme parametre indique ou trouver le fichier .afm que nous avons genere 
terieurement. II est indispensable. 

Le troisieme parametre indique, par une chaine de caracteres, le type d'encodage a 
utiliser. II peut prendre les valeurs suivantes : 

cpl250 ' (Europe centrale) 

cpl251 ' (cyrillique) 

cpl252 ' (Europe de l'Ouest) 

cpl253 ' (grec) 

cpl254' (turc) 

cpl255 ' (hebreu) 

cpl257 ' (pays baltes) 

cpl258 ' (vietnamien) 

cp874' (thai) 

ISO-8859-1 ' (Europe de l'Ouest) 

ISO-8859-2 1 (Europe centrale) 

ISO-8859-4 1 (pays baltes) 

ISO-8859-5 1 (cyrillique) 

ISO-8859-7 1 (grec) 

ISO-8859-9 1 (turc) 

ISO-8859-1 1 1 (thai) 

ISO-8859-15 1 (Europe de l'Ouest) 

ISO-8859-16 1 (Europe centrale) 

K0I8-R 1 (russe) 

K0I8-U 1 (ukrainien) 

II faut, bien entendu, que votre fichier de police dispose des caracteres correspondant a 
l'encodage choisi. Vous n'avez plus qu'a lancer le fichier fpdf_export_font.php dans votre 
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navigateur. Le fichier comic.php aura ete genere dans le meme repertoire que 
fpdf_exportJont.php. 

(J) Compresser sa police 

Si vous avez la compression ZLIB activee, le fichier comic. z sera aussi genere. II contient aussi votre 
police, mais compressee. 



Troisieme et demiere etape : utiliser la police 

Copiez les fichiers comic.php, comicz (s'il a ete genere) et eventuellement (pour le ranger 
au meme endroit) le fichier comic.ttf dans votre repertoire chap04\fpdfrfont. Nous 
pouvons enfin utiliser la police Comic dans notre prochain document PDF. Voyons 
comment s'y prendre. Creez, dans votre repertoire chap04, le fichier Jpdf_comic.php et 
remplissez-le comme suit : 

*^£ fpdf_comic.php 

<?php 

require ( ' fpdf /fpdf . php' ) ; 
$pdf=new FPDF () ; 
$pdf->AddPage ( ) ; 

//Ecrire une chaine 

$pdf->AddFont ( ' Comic' , " ) ; 

$pdf->SetFont ('Comic' , 'U' , 16) ; 

$pdf->Cell (100, 0, utf8_decode ('Une police importee ! ' ) ) ; 

$pdf->Output () ; 
?> 



Vous pouvez, si vous le souhaitez, lancer ce fichier depuis votre navigateur prefere. 



Fichier Edition Affichage Histcriqus tlarcjue-pages Outils ? 

^ " ' ■■' " ^ iS L U htt P ; // |oi:alhosl: / D V ria,Tlise2%20PHp / i:na P 04 /fP d|: -Comic.ph| 



19 a £- 



[T] I 1 I © © I 83,3% | . 



E3 l\E 



Une police importee ill 



Fig. 4.13: 

La police importee 
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Voyons maintenant la derniere fonction de notre etude de FPDF : la fonction AddFont(). 

Cette fonction sert a importer dans notre document la police de caracteres dont nous 
avons besoin. Le deuxieme parametre n'est pas obligatoire, mais il definit le style de la 
police. 

Une police TrueType est en fait organisee en plusieurs fichiers : un fichier pour les 
caracteres normaux, un pour les caracteres en italique, un pour les gras et un pour les gras 
italiques. Nous n' avons, dans notre exemple, traite que le fichier contenant les caracteres 
normaux. C'est pour cela que nous mettons une chaine vide comme deuxieme argument. 
Si nous avions choisi de traiter aussi les caracteres gras, nous aurions appele une seconde 
fois la fonction AddFontQ, de cette maniere : 

$pdf->AddFont ('Comic' , 'B') ; 



4.4 Signer un document PDF 



Ouvrez votre fichier fpdf_comic.php dans votre navigateur, puis faites la combinaison de 
touches [Ctrl] +fp], afm d'ouvrir la fenetre des proprietes du document. Vous remarquerez 
que tous les champs sont vides. 



D ^ CM !* ?.: Protection Polices Avancees 



Description 


' 


Fichier : 

Titre : 

Auteur : 

5ujet : 

Mots-cles : 


f..lr_.. (... r.-.r 










Date de creation : 


H/l 2/2007 18:10:04 


Modifie le : 




Application : 





Description avani.ee 
Outil de conversion PDF : 


FPDF 1,53 






Version PDF : 


1.3(Acrobat4.x) 






Taille du fichier : 


89,42 Ko (91 562 octet?) 






Format de page : 


210 x 297 mm 


Nornbre de pages : 


1 


PDF balise : 


Non 


Affichage Web rapide : 


Non 



Fig. 4.14: Que de champs vides.. 
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Nous allons y remedier. Ajoutez ce code a votre fichier fpdf_comic.php, juste avant 
l'appel a la fonction Output () : 

//proprietes du document 
$pdf->SetAuthor ( ' RedFish' ) ; 
$pdf->SetCreator (' Fait avec FPDF'); 
$pdf->SetKeywords ( ' FPDF RedFish PHP'); 
$pdf->SetSubject (' Police Comic Font import'); 
$pdf->SetTitle (utf 8_decode ('La police comic, ttf')); 

Les noms de ces fonctions sont explicites, ne trouvez-vous pas ? Elles ne prennent toutes 
qu'une seule chaine de caracteres comme argument. Vous pouvez relancer votre 
fpdf_comic.php depuis votre navigateur, et regarder les proprietes de votre document. 



; Proprietes du document 



[■»•>:. i[.h.:.r, |f,, : j^,;ri,;,r, || Fv.li.;~-/. || A ar,;^.- 1 



Description 




Fichier : 

Titre : 

Auteur : 

Sujet : 

Mots-des : 


pdfjiornic.php 


La police comic. ttf 


RedFish 


Police Comic Font import 


FPDF RedFish PHP 


Date de creation : 


114/12/2007 18:18:37 


Modifie le : 




Application : 


z ait avec FPDF 



Description avancee 








Outil de conversion PDF : 


FPDF 1,53 






Version PDF : 


1.3 (Acrobat 4.x) 






Taille du fichier : 


89,55 Ko (91 700 octets) 






Format de page : 


210 x297 mm 


Nombre de pages : 


1 


PDF balise : 


Non 


Affichage Web rapide : 


Non 



OK [ Annuler | 



Fig. 4.15: Les champs sont remplis ! 
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4.5 Check-list 

Nous avons termine l'etude de FPDF. Dans ce chapitre, nous avons vu comment : 

*/ generer des documents PDF avec PHP, les enregistrer localement, les afficher sur le 
navigateur ou proposer aux utilisateurs de les telecharger ; 

s/ importer des images dans un document PDF ; 

*/ ecrire du texte, des blocs de texte et creer des tableaux ; 

*/ utiliser les fonctions de dessins de FPDF ; 

s/ creer des en-tetes et des pieds de page ; 

<y importer une police TrueType ; 

^ signer vos documents PDF 
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Aujourd'hui, les bases de donnees sont utilisees a tout 
bout de champ et ce, meme lorsque d'autres solutions 
s'averent plus efficaces et plus rapides. Vous allez 
comprendre que LDAP s'adapte aussi tres bien lorsqu'il 
s'agit de gerer un ensemble d'etres humains (employes, 
contacts professionnels, etc.). 
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5.1 LDAP ? Qu'est-ce que c'est ? 

LDAP est un acronyme pour Lightweight Directory Access Protocol. Comme vous 
pouvez le voir par son dernier mot (Protocol), LDAP est un protocole comme il en existe 
beaucoup en informatique : HTTP, TCP, IP, etc. 

En francais, on pourrait le traduire, plus ou moins litteralement, par "protocole d'acces a 
un repertoire de taille legere", le terme Lighweight etant aussi utilise en boxe pour 
designer une categorie de poids... tres leger bien stir. 

Le mot Directory signifiant repertoire, LDAP obeit bien a la logique des fichiers et 
dossiers au niveau de l'arborescence. En fait, LDAP fonctionne comme un systeme 
d'arborescence de dossiers et fichiers mais pour des informations afin de creer un 
annuaire contenant une section (souvent appelee Monde), des sous-sections, des sous 
sous-sections, et ainsi de suite. 

Vous allez decouvrir, dans la partie qui suit, 1' installation sous Windows. En ce qui 
concerne 1' installation sous Linux, LDAP est souvent installe par defaut avec la 
distribution. Cependant, pour ceux qui ne l'ont pas, reportez-vous a l'aide de votre 
distribution de Linux. Les commandes different quelque peu et les versions aussi en 
fonction de la distribution de Linux que vous utilisez : Debian, Gentoo, RedHat, 
Mandrake, etc. Puis, arm de bien comprendre comment fonctionne LDAP, vous concevrez 
l'arborescence de 1' annuaire qu'il sera necessaire de mettre en place dans le cas pratique 
et vous verrez comment agir sur LDAP avec PHP. Pour fmir, vous mettrez en pratique 
l'arborescence concue pour creer un annuaire qui vous permettra de memoriser tous vos 
contacts professionnels et/ou personnels. LDAP etant tres simple a utiliser, le cas pratique 
se fera tout au long de la section Manipulations dans LDAP et vous aurez le code complet 
place en fin de chapitre comme pour les autres extensions etudiees precedemment. Seuls 
des formulaires HTML de saisie seront ajoutes dans les scripts du cas pratique 

5.2 Installation 
Windows 

Allez sur le site http://download.bergmans.us/openldap et cliquez avec le bouton gauche de la 
souris sur le repertoire openldap-x.x.xx. Au moment de l'ecriture de cet article, la derniere 
version etait 2.2.29. 

Une fois dans ce repertoire, vous devez telecharger le fichier openldap-2.2.29-db-4 
.3.2 9-openssl-0. 9. 8a-win32_Setup. exe . 
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I Index of /openldap/openldap-2.2.29 



Lastmo^iBd Size Description 



4p Parent Directory 

|5 openldap-2.2.29-db-4.3.29-openssl-0.9.Sa-BDB QNLY-win32 Setup.exe 13-Jan-2006 07:11 1.5M 



Apache/2.2. :< (Dsbian) Server at drjw?Haad/berg)nans.us Port '. 



nldap-2.2.29-db-4.3.29-openssl-0.9.8a 



Vous avez choisi d'ouviir 
[jj| ...-2.2.29-db-4.3.29-openssl-u.9.Ba-win32_Setup.eite 
qui est un fichier de type : Application 
a partii de : http://download.beigmans.us 

Voulez-vous enregistier ce lichiei ? 



Enregistrei le fichier I Annuler 



Fig. 5.1 : Telechargerlefichier.exe 



Puis installez-le. Cela se fait en quelques etapes seulement. Commencez par choisir 
la langue. Le choix est restreint : anglais (English) ou allemand (Deutsch). 



EE3g 



A _ j Seieci (he language to use Ju : ;r:c the installation: 



E 



1 Cancel | 



Fig. 5.2 : 

Choisir la langue 



Fermez tous les programmes actifs, pensez surtout a desactiver 1' antivirus, et cliquez 
sur Suivant. 





T-mmmm 


& 


Welcome to the OpenLDAP Setup 
Wizard 

This will install openld?p-2 .2. 29 on your computer. 

': is recommended that you -icse all oiher applications before 
continuing. 

Click Ne;*:t to continue. 01 Cancel to eKii Setup. 


















































| N ext | Cancel | 











Fig. 5.3 : 

Depart de I'installation 
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Acceptez la licence et cliquez sur Suivant. 



iff Setup - OpenLDAP 



License Agreement 

Please read the following important information before continuing. 



Please read the following License Agreement. You must accept the terms of this 
agreement before continuing with the installation. 



The OpenLDAP Public License 
Version 2.8, 17 August 2003 

Redistribution and uie of this ioilwaie and -associated documentation 
("Software"), with or without modification, are permitted provided 
that the following conditions are met: 

1. Redistributions in source form must retain copyright statements 
and notices, 

2. Redistributions in binary form must reproduce applicable copyright 

(* I accept the agreement 

C I do not accept the agreement 




Fig. 5.4: 

Acceptez la licence 









5 Choisissez ensuite la destination d' installation, vous pouvez laisser le chemin par 
defaut. 





|l# Setup- OpenLDAP H H E3 I 






Select Destination Location 

Where should OpenLDAP be installed? 






j Setup will install OpenLDAP into the following folder. 
To continue, click Next. If you would like to select a different folder, click Browse. 






-' leb ' u T HE: or rtee di t t>:r reamed 












< Back || Next? | Cancel | 











► Fig. 5.5 : 

Destination d'installation 



6 Si vous desirez installer aussi slurpd, cochez la case correspondante. slurpd et slapd. 
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iff Setup - OpenLDAP 



JE\ 



L 



Select Components 

Which components should be installed? 



Qa 



Select the components you want to install; clear the components you do not want to 
install. Click Next when you are ready to continue. 



Full installation 


J 


© install OpenLDAP openldap-2.2.29 
install BDB-tools 


10,7 MB 1 
0,3 MB 


^■ntinstall 1 Ipenl hAH-slapH as N 1 service i 


l~l install OpenLDAP-slurpd as NT service 



Current selection requires at least 11,4 MB of disk space. 



| < Back ~|| Newt > | Cancel | 



Fig. 5.6 : 

Choisir les outils d 
installer 



Si vous desirez un dossier dans le menu Demarrer, saisissez un nom ou laissez celui 
par defaut. Si vous ne voulez par qu'un dossier soit dans le menu Demarrer, cochez 
la case en bas a gauche. 



iff Setup - OpenLDAP 



M 



Select Start Menu Folder 

Where should Setup place the program's shortcuts? 




Setup will create the program's shortcuts in the following Start Menu folder. 
To continue, click Newt. If you would like to select a different folder, click Browse, 



Fig. 5.7: 

Dossier dans menu 
Demarrer 



I - Don't create a Start Menu folder 



8 Pour l'etape suivante, il vaut mieux laisser la premiere option cochee. Cela permettra 
de demarrer le demon LDAP chaque fois que vous allumerez votre ordinateur. A 
vous de decider si vous desirez placer une icone sur le bureau ou non. Dans 
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1' affirmative, il est vivement conseille de cocher l'option. Cela vous permettra de 
demarrer slapd aussitot 1' installation sans avoir a redemarrer votre ordinateur. 



rtS Setup - OpenLDAP 



Select Additional Tasks 

Which additional tasks should be performed? 



una 

IB 



Select the additional task: you would like Setup to perform while installing OpenLDAP, 
then click Newt. 

fV automatically start OpenLDAP NT service(s) after reboot 
Additional icons: 



I iLreate a desktop icon 



<Back [ Newt> j Cancel | 



Fig. 5.8 : 

Demarrage a chaque 
boot de Windows 



Procedez a un dernier controle pour etre sur que toutes les bonnes informations ont 
ete selectionnees. Si tout est correct, cliquez sur Install. 



|# Setup - OpenLDAP 



Ready to Install 

Setup is now ready to begin installing OpenLDAP on your computer. 
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Click Install to continue with the installation, or click Back if you want to review or 
change any settings. 



Destination location: 

C:\Program Files\OpenLDAP 

Setup type: 

Custom installation 

Selected components: 

install OpenLDAP openldap-2.2.2S 
install BDB-tools 

install OpenLDAP-slapd as NT service 
install OpenLDAP-slurpd as NT service 



Start Menu folder: 




{Back | install | Cancel | 



Fig. 5.9 : 

Verifications avant 
installation 



lOTerminez 1' installation. 



IBS 



Installation 



h (3 Setup - OpenLDAP 
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Completing the OpenLDAP Setup 
Wizard 



Setup has finished installing OpenLDAP on your computer. The 
application may be launched by selecting the installed icons. 



Click Finish to exit Setup. 
El Mew README. tx| 



Fig. 5.10: 

Cliquezsur Finish 



Et voila, vous avez reussi 1' installation. 

Maintenant que 1' installation est terminee, il ne vous reste plus qu'a passer a la 
configuration. Editez le fichier slapd.conf. Si vous avez laisse la destination par defaut 
lors de 1' installation, ce fichier se situe dans C:\Program Files\OpenLDAF\. A la fin du 
fichier, vous pouvez prendre connaissance de la configuration par defaut. Vous pouvez 
laisser en l'etat pour les tests de ce chapitre. 



52 MMMMMMMMMMMMMMMM###############################1 

53 # EDE database definitions 

54 Mnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnni 

55 

56 database bdb 

57 suffix "dc=domaine, dc=org" 

58 rootdn "cn= Manager, dc=domaine, dc=org" 

59 # Cleartext passwords, especially for the rootdn, should 

# be avoid. See slappasswd (8) and slapd. conf (5) for details. 

61 # Use of strong authentication encouraged. 

62 rootpw secret 

# The database directory MUST exist prior to running slapd AND 

64 # should only be accessible by the slapd and slap tools. 

65 # Mode 700 recommended. 

66 directory ./data 

67 # Indices to maintain 

68 index objectClass eg 



Fig. 5.1 1 : slapd.conf edite avec Notepad++ 
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Fermez le fichier et cliquez deux fois rapidement (double-clic) sur l'icone de votre 
bureau. Une fenetre MS-DOS s'ouvre. Cette fenetre doit rester ouverte autant de temps 
que vous utilisez LDAP. Par confort de travail, certains prennent 1' habitude de la reduire. 




Fig. 5.12: LancementdeOpenLDAP 

Toujours dans le repertoire C:\Program Files\OpenLDAP , creez un fichier que vous allez 
nommer defaut. ini et saisissez les lignes suivantes : 



dn: dc=domaine, dc=org 


objectclass : 


top 


objectclass : 


dcObject 


objectclass : 


organization 


o: Domaine 




dc : domaine 





Puis ouvrez une fenetre MS-DOS en double-cliquant sur l'icone qui s'est placee sur votre 
Bureau lors de 1' installation. Une fenetre MS-DOS va s'ouvrir avec le prompt 
directement place dans C:\Program Files\OpenLDAP . Saisissez la commande si apadd -f 
si apd . conf -1 conf i g . i ni . Si tout s'est bien passe, rien ne s'est affiche a part le prompt 
dans la ligne en dessous. Fermez la fenetre MS-DOS puis allez dans le repertoire LDAP 
et double-cliquez sur l'icone slapd.exe. LDAP est maintenant demarre et est fonctionnel. 

II vous reste a present une autre procedure a effectuer concernant la partie PHP. Modifiez 
le fichier php.ini et dans la section Dynamic Extensions du fichier, enlevez le 
point-virgule ( ; ) a la ligne ;extension=php_ldap, enregistrez le changement, fermez le 
fichier php.ini et redemarrez le serveur web (Apache2). Vous allez maintenant verifier si 
tout s'est bien passe en vous connectant a LDAP via PHP. Creez un repertoire chap05 
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dans le repertoire dynamisez_php. Puis creez le fichier connexion_deconnexion.php dans 
le repertoire chap05 et inserez dans le fichier le code suivant : 



*^£ testerjdap.php 



<?php 

$ldc = ldap_connect (' localhost' ) ; 

if (!$ldc) { 

echo 'Impossible de se connecter au serveur LDAP'; 

} else { 

echo 'Connexion au serveur LDAP effectuee avec succes'; 
} 

ldap_close ($ldc) ; 
?> 

Executez le script dans votre navigateur et si tout s'est bien passe, le message "Connexion 
au serveur LDAP effectuee avec succes" se sera affiche. Si c'est votre cas, vous n'avez 
plus qu'a vous feliciter. Vous pouvez passer a la section : Interaction entre PHP et LDAP. 

Linux 

En ce qui concerne 1' installation sous Linux, voici quelques sites en fonction de votre 
distribution sur lesquels vous pourrez aller pour installer LDAP sur votre distribution 
Linux. 

Debian 

Pour cette installation, nous nous sommes bases sur la ressource trouvee a la page web 
de Coagul, www.coagul.org/article.php3?id_article=172. 

En principe, LDAP fait partie integrante de Linux. Cependant, des que Ton prend un peu 
d' assurance avec le systeme Linux, on a tres vite envie de se faire sa propre configuration 
en installant les packages en fonction de ses besoins. Nous partons done du principe que 
LDAP n'est pas encore installe. Nous allons vous expliquer etape par etape comment 
installer et configurer OpenLDAP sur une Debian. Pour cette installation, vous pouvez 
utiliser Etch (stable) sur un ordinateur portable premier prix. 

Ouvrez une console. II en existe plusieurs sous Linux : xterm, eterm, etc. Saisissez la 
commande su suivi du mot de passe de 1' administrateur Linux {root) demande. Vous 
savez que vous etes connecte en tant qu' administrateur root lorsque, juste avant le 
curseur, vous avez le signe diese (#) au lieu du signe dollar ($). 
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Listez les paquets concernes par OpenLDAP en saisissant la commande suivante : 
apt-cache search openldap: 

Ubldap2 — OpenLDAP libraries ; 

gforge-ldap-openldap — collaborative development tool — LDAP directory (using 

OpenLDAP) ; 

Idap-utils — OpenLDAP utilities ; 

Idapscripts — Add and remove user and groups (stored in a LDAP directory) ; 

libdbd-ldap-perl - Perl extension for LDAP access via an SQL/Perl DBI interface ; 

libldap-2.3-0 — OpenLDAP libraries ; 

libldap-rubyl.8 — OpenLDAP library binding for Ruby 1.8 ; 

Ubldap2-dev — OpenLDAP development libraries ; 

libsasl2-modules-ldap — Pluggable Authentication Modules for SASL (LDAP) ; 

python-ldap — A LDAP interface module for Python ; 

slapd — OpenLDAP server (slapd) ; 

smbldap-tools — scripts to manage Unix and Samba accounts stored on LDAP. 

Tous ces paquets ne sont pas indispensables pour utiliser LDAP via PHP En fait, seuls 
le serveur et le client LDAP sont necessaires. Dans certaines documentations, la 
commande indiquee pour installer LDAP est : 

# apt-get install ldap-server ldap-client 

Or, sous Etch, cette commande affiche une note comme quoi ldap-server sera remplace 
par slapd et ldap-client sera remplace par ldap-utils. D'ailleurs, il est tres facile de 
remarquer que si apd et 1 dap-uti 1 s sont visibles dans la liste des paquets precedents alors 
que ldap-server et ldap-client ne le sont pas. 

1 Commencez 1' installation : 

# apt-get install slapd ldap-utils 

Editez le fichier de configuration : 

# nano /etc/ldap/slapd . conf 

3 Modifiez la ligne 57 du fichier : 

suffix "dc=mon annuaire, dc=org" 

Decommentez la ligne 6 1 et modifiez-la : 

rootdb "cn=Manager, dc=mon annuaire, dc=org" 



IBB 



Installation 



5 Puis ajoutez a la ligne suivante : 



rootpw secret 




Pour finir, modiflez les lignes 96 a 100 : 



access to attrs=UserPassword, shadowLastChange 

by dn="cn=Manager, dc=mon annuaire, dc=org" 
by anonymous auth 
by self write 
by * none 

7 Ainsi que les lignes 115 a 177 : 



access to 


• 






by 


dn="cn=Manager 


dc=mon annuaire, dc=org" 


write 


by 


* read 







Et c'est fini. II ne reste plus qu'a redemarrer le serveur LDAP avec la commande 
suivante : 

# /etc/init .d/slapd restart 

Vous devez ensuite verifier que LDAP est reconnu par PHP Pour cela, executez le fichier 
PHP qui contient la fonction phpinfo(). Ensuite, assurez-vous que la connexion a LDAP 
fonctionne par le biais de PHP avec la configuration qui a ete modifiee. Executez dans un 
navigateur le script suivant : 

J^£ testerjdap.php 

<?php 

$ldc = ldap_connect (' localhost' ) ; 

if (!$ldc) { 

echo 'Impossible de se connecter au serveur LDAP'; 

} else { 

echo 'Connexion au serveur LDAP effectuee avec succes' ; 
} 

ldap_close ($ldc) ; 
?> 

Enfin... il y a eu bonne decouverte de LDAP avec PHP 

Gentoo 

Rendez-vous sur le site suivant : www.gentoo.org/doc/fr/ldap-howto.xml. 
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RedHat 

Rendez-vous sur www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/fr/ref-guide/index.htnil et 
cliquez sur le lien "13 Protocole LDAP (Lightweight Directory Access Protocol)" . 

Suse 

LDAP est installe par defaut avec Suse. 

5.3 Gerer LDAP avec PHP 

Se connecter/deconnecter 

Connexion 

Se connecter au serveur LDAP est aussi simple que de se connecter a un serveur MySQL. 
La fonction se nomme ldap_connect() et sa syntaxe est la suivante : 

ressource ldap_connect([chaTne $nom_serveur[, entier $port]]); 

La fonction prend en premier parametre, optionnel, le nom du serveur LDAP 
($nom_serveur) et en second parametre, egalement optionnel, le numero de port ($port) 
sur lequel LDAP ecoute les requetes qui lui sont destinees. Le port par defaut en ce qui 
concerne LDAP est le port TCP 389. Le resultat retourne par LDAP est un identifiant de 
connexion en cas de succes et FALSE en cas d'echec. Le resultat de FALSE concerne la 
version 3 de LDAP uniquement. 

(D LDAP 2.X.X ^ 

Avec LDAP 2.X.X, ldap_connect() retournera toujours un identifiant, que la connexion reussisse ou non. 
En cas d'echec, il retournera une ressource en initialisant uniquement les identifiants de connexion. 

<?php 

$ldc = ldap_connect (' localhost' , 389) 

or die (' Impossible de se connecter au serveur LDAP'); 

/* instructions */ 
?> 



IBS 



Gerer LDAP avec PHP 



(j) die() vs Exception 

Afin de faciliter la comprehension, et de raccourcir le code, nous avons utilise la fonction die(). 
Cependant, cette fonction est a eviter pour une question de securite. De plus, depuis la version 5 de 
PHP, les exceptions sont comprises par defaut dans le noyau de PHP et nous vous conseillons vivement 
de les utiliser dans vos projets. Si ce n'est pas le cas, etudiez les exceptions serieusement et integrez-les 
dans vos projets. 

La variable $ldc est l'identifiant de connexion (en anglais : link_identifier). 

Deconnexion 

La deconnexion est encore plus simple que la connexion et se passe totalement de 
commentaires : 

int ldap_close(ressource $id_connexion) 

<?php 

/* instructions */ 

ldap_close ($ldc) ; 
?> 

Manipulations dans LDAP 

Authentification au serveur LDAP : ldap_bind() 

bool ldap_bind(ressource $id_connexion 
[, chaTne $bind_rdn [, chaTne $bind_pass]] ) 
Plutot que vous donner longue definition, voici du code : 

&& mauvaise_authentification.php 

<?php 

$ldc = ldap_connect (' localhost' ) or die (' Impossible de se connecter au 

•■» serveur LDAP' ) ; 

echo $ldc .'<br/>'; 

// Authentification au serveur LDAP 

echo 'Authentification avec <code>ldap_bind ( ) </code> : ' ; 

$ldb = ldap_bind($ldc) ; 

echo $ldb; 
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ldap_close ($ldc) ; 
?> 



Utiliser le script tel quel va vous generer un message d'erreur Warning exprimant un 
probleme de protocole : 



Resource id #2 

Authentication avec ldap_bind() : 1 



Fig. 5.13: 

Warning a I'authentification 



Pourquoi ? Le serveur LDAP est en version de protocole 3 alors que PHP envoie ses 
ordres en version de protocole 2. II est done necessaire d'ajouter la ligne : 

ldap_set_option($ldc, LDAP_0PT_PR0T0C0L_VERSI0N, 3); avant la ligne $ldb = 
ldap_bind($ldc) ; arm de permettre I'authentification (anonyme) au serveur LDAP 

^* bonne_authentification.php 

<?php 

$ldc = ldap_connect (' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 
echo $ldc . '<br/>'; 

// Authentif ication au serveur LDAP 
echo 'Authentif ication avec <code>ldap_bind () </code> : ' ; 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

$ldb = ldap_bind($ldc) ; 
echo $ldb; 

ldap_close ($ldc) ; 
?> 

bool ldap_set_option(ressource $id_connexion, 

entier $option, mixte $nouvel le_valeur_option) ; 

$option correspond done a une option dont celle-ci possede deja une valeur, attribuee par 
defaut par PHP, que vous desirez modifier (la valeur). Le premier parametre, 
$id_connexion, est l'identifiant de connexion defini lors de l'appel de la fonction 
ldap_connect() et le troisieme, $nouvel le_valeur_option, correspond a la nouvelle 
valeur que vous voulez affecter a l'option placee en deuxieme parametre. 
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Les options possibles sont des constantes predefmies dans l'extension LDAP de PHP : 

LDAP_OPT_DEREF (entier) determine comment les aliases sont considered durant la 

recherche. II doit avoir pour valeur une de celles qui suivent : LDAP_DEREF_NEVER, 

LDAP_DEREF_SEARCHING, LDAP_DEREF_FINDING ou LDAP_DEREF_ALWAYS. 

LDAP_OPT_SIZELIMIT (entier) deflnit une limite dans le nombre de resultats retournes 

par une recherche (vous pouvez par exemple retourner les 100 premiers noms meme 

si la recherche en trouve un nombre superieur). La valeur a cette option demande 

de retourner tous les resultats sans limite. 

LDAP_OPT_TIMELIMIT (entier) impose une limite de temps maximal, en secondes, 

pour effectuer une recherche. La valeur indique qu'il n'y a aucune limite de temps 

imposee. 

LDAP_0PT_PR0T0C0L_VERSI0N (entier) indique le protocole de version LDAP utilise 

arm de communiquer avec le serveur LDAP primaire. 

LDAP_0PT_ERR0R_NUMBER (entier). 

LDAP_OPT_REFERRALS (booleen). La valeur de cette option doit etre definie par 

LDAP_0PT_0N ou LDAP_0PT_0FF. Cette option est a ON par defaut. 

LDAP_OPT_RESTART (booleen) determine si les operations d'entrees/sorties de LDAP 

sont automatiquement redemarrees ou non en cas d'echec. La valeur de cette option 

doit etre definie par LDAP_0PT_0N ou LDAP_0PT_0FF. Par defaut, cette option est a OFF. 

LDAP_0PT_H0ST_NAME (chaine). 

LDAP_OPT_ERROR_STRING (chaine) defmit un message d'erreur a retourner lorsqu'une 

erreur se produit dans la session LDAP. 

LDAP_OPT_MATCHED_DN (chaine) fournit la valeur DN retournee avec la plus recente 

erreur produite dans la session LDAP. 

LDAP_0PT_SERVER_C0NTR0LS (tableau) fournit une liste par defaut de controles du 

serveur LDAP envoyee avec chaque requete a effectuer. 

LDAP_0PT_CLIENT_C0NTR0LS (tableau) fournit une liste par defaut des controles du 

client affectant la session LDAP. 

Ecriture dans LDAP 

Ajouter un pays 

Voici venu le moment d' effectuer des ajouts dans LDAP. II est necessaire de bien 
comprendre LDAP et son fonctionnement auparavant. LDAP fonctionne sous forme 
d'arborescence. II y a un repertoire racine, souvent appele Monde, puis des 
sous-repertoires. En fait, "Monde" correspond au domaine (dc=mon_annuaire,dc=org 
dans les exemples de ce chapitre). 
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/!\ Caracteres accentues 

LDAP ne prend pas en compte les caracteres accentues. Par exemple, si vous essayez d'ajouter une 
personne dont le prenom est Frederic, il faut inserer Frederic sinon vous obtiendrez un message d'erreur 
de type "ldap_add() : Invalid Syntax..." 

Si vous avez lu le fonctionnement par hierarchie de LDAP, vous comprenez que le 
premier objet a ajouter dans l'annuaire LDAP est le pays. Regardez le fichier 
ajouter_un_pays.php : 



J^£ ajouter_pays.php 



<?php 

$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 

$passldap = 'secret'; 

$ldc = ldap_connect (' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP') 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ($ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter pays : definition des informations 

$info['c'] = 'France'; 

$inf o [' objectClass' ] [0] = 'country'; 

$info['objectClass' ] [1] = 'top'; 

$rdn = ' c=' . $info['c'] . ' , dc=mon annuaire, dc=org' ; 

// Ajouter les donnees dans l'annuaire 
$lda = ldap_add ($ldc, $rdn, $info) ; 
if ($lda) { 

echo 'ajout dans annuaire LDAP effectue avec succes' ; 
} else { 

echo 'ajout dans annuaire LDAP echoue' ; 
} 

ldap_close ($ldc) ; 
?> 

Analyse du code et explications 

Ligne 5: $dn = 'cn=Manager,dc=mon_annua"ire,dc=org' ; 
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dn signifie distinguished name que Ton pourrait traduire en francais par nom unique 

(litteralement : nom distingue) ; 

en signifie commonName (nom commun) ; 

dc signifie domainComponent (composants domaine) et contient toutes les 

composantes du nom de domaine. Si vous avez un nom de domaine du style 

domaine.asso.fr, alors vous devrez avoir la ligne suivante : $dn = 'cn=Manager 

,dc=domaine,dc=asso,dc=fr' ;. 

Ligne 16: $ldb = ldap_bind($ldc, $dn, $passldap); 

Pour pouvoir ajouter des informations dans l'annuaire, l'utilisateur doit s'identifier 
au serveur LDAP. Une connexion anonyme, comme vue dans les exemples 
precedents, n'est done pas possible. C'est pour cette raison que la fonction 
ldap_bind() contient la ressource de connexion en premier parametre et egalement 
le domaine en deuxieme parametre et le mot de passe en troisieme parametre. 
La syntaxe de la fonction ldap_bind() est la suivante : bool ldap_bind (resource 
link_id [, string rdn [, string pass]] ). Les deuxieme et troisieme parametres 
sont optionnels pour la lecture dans l'annuaire mais obligatoires pour pouvoir y 
inserer des donnees. En indiquant le premier parametre dans la fonction, 
l'authentification est dite anonyme. 

Ligne 20 : $info['c'] = 'France 1 ; 

$info['c'] definit le pays, c signifie countryName (nom du pays). Si vous voulez 
respecter la norme RFC4519, vous devrez remplacer la valeur France par FR qui est 
le code A2 de la norme ISO-3166-2 pour la France. 

Ligne 26: $1 da = ldap_add($ldc, $rdn, $info); 

1 dap_add () est la fonction qui permet d'ajouter du contenu dans le repertoire LDAP. 

LDAP est tenement riche qu'il est impossible d'en faire le tour en quelques pages. Si vous 
voulez plus de renseignements sur LDAP, nous vous conseillons de consulter les annexes ou 
vous trouverez de nombreuses references a des ouvrages et des sites sur Internet. 

Ajouter une organisation 



*^£ ajouter_organisation 

<?php 
/** 

* ajouter_une_org.php 
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*/ 

$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 
$passldap = 'secret'; 

$ldc = ldap_connect (' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind($ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter une organisation : definition des informations 

$info['o'] = 'nom organisation'; 

$inf o [' objectClass' ] [0] = 'organization'; 

$info['objectClass' ] [1] = 'top'; 

$rdn = ' o=' . $info['o'] . ' , c=France, dc=mon annuaire, dc=org' ; 



// Ajouter les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 
} else { 

echo 'ajout dans annuaire LDAP echoue<br/>' ; 
} 

ldap_close ($ldc) ; 
?> 

Comme vous pouvez le remarquer, les changements par rapport a l'ajout d'un pays sont 
minimes. La fonction ldap_add() fonctionne de la meme maniere pour l'ajout d'une 
organisation que pour l'ajout d'un pays. Elle fonctionnera d'ailleurs de la meme maniere 
pour l'ajout d'une unite et egalement pour l'ajout d'un individu (contact). 

Ajouter une unite 



^j ajouter_unite.php 



<?php 

* ajouter_une_unite .php 

*/ 
$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 
$passldap = ' secret' ; 



154 



Gerer LDAP avec PHP 



$ldc = ldap_connect (' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ($ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter une organisation : definition des informations 

$info['ou'] = 'contacts personnels'; 

$inf o [' objectClass' ] [0] = ' organizationalUnit' ; 

$info['objectClass' ] [1] = 'top'; 

$rdn = ' ou=' . $info['ou'] 

*♦ . ' , o=drapeau suire, c=France, dc=mon annuaire, dc=org' ; 

// Ajouter les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : ' . $rdn .'<br/>'; 
} else { 

echo 'ajout dans annuaire LDAP echoue<br/>' ; 
} 

ldap_close ( $ldc) ; 
?> 

Tout comme pour l'ajout d'un pays ou d'une unite, la logique de fonctionnement de 
LDAP reste la meme. Voila un element supplemental qui fait tout l'interet de LDAP : 
sa simplicite d' utilisation. II est bien plus complique de concevoir l'arbre (arborescence) 
LDAP en lui-meme (en fonction de la complexite de la structure a mettre en place) que 
de le programmer par la suite pour le rendre operationnel. 

Ajouter un individu 

Tout comme pour les bases de donnees, il est indispensable, dans un annuaire LDAP, de 
definir un nom unique (une cle) pour chaque entree. Par exemple, il peut y avoir plusieurs 
David DRAPEAU (sn) mais un seul ddrapeau (en) 

<^jt ajouterjndividu.php 

<?php 

$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 
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$passldap = 'secret'; 

$ldc = ldap_connect (' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind ($ldc, $dn, $passldap) 

or die (' Authentif ication au serveur LDAP echouee' ) ; 

// Ajouter une organisation : definition des informations 

$info ["en"] = "ddrapeau"; 

$info ["sn"] = "David DRAPEAU"; 

$info [ "userPassword" ] = "unmotdepasse" ; 

$info ["objectClass"] [0] = "person"; 

$info['objectClass' ] [1] = 'top'; 

$rdn = ' cn=' . $info['cn'] . ' , ou=nom unite 01, 

o=nom organisation 01, c=France, dc=mon annuaire , dc=org' ; 

// Ajouter les donnees dans 1' annuaire 
$r = ldap_add ($ldc, $rdn, $info) ; 
if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 
} else { 

echo 'ajout dans annuaire LDAP echoue<br/>' ; 
} 

ldap_close ($ldc) ; 
?> 

Ann de rester tres clair et concis, des elements comme l'adresse e-mail (liste de diffusion 
par exemple) ou le numero de securite sociale (employes d'une societe par exemple) 
n'ont pas ete pris en compte. Ajouter ces elements ne complique en rien la 
programmation LDAP avec PHP. 

Recherche/Lecture 

ldap_get_entries() 

Evidemment, une autre fonctionnalite primordiale d'un annuaire est de pouvoir acceder 
de nouveau a ses contacts. La fonction ldap_get_entries() est indispensable afin de 
stacker les donnees dans un tableau multidimensionnel. 

array ldap get entries(ressource $id connexion, ressource $id resultat) 
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Le second parametre $id_resul tat represente la valeur de retour de la fonction 
ldap_search(). 

ldap_search() 

Puis, il suffit d'utiliser ldap_search() associee a ldap_get_entries(). 

resource ldap_search(ressource $id_connexion, 

chaTne $base_dn, chaTne $filtre[, tableau $attributs 

[, entier $attrs_seuls [, entier $taille_max[, entier $timel imit 

[, entier $deref]]]]]) 

Comme vous pouvez vous en apercevoir, la fonction ldap_search() possede beaucoup de 
parametres. En voici la description : 

$id_connexion est l'identifiant de connexion defini par ldap_connect 

$base_dn est le DN (nom distingue) de base du dossier 

$f i 1 tre est le motif de recherche a effectuer ; 

$attributs permet de filtrer au niveau du retour de resultat. C'est-a-dire qu'il ne 

peut retourner que le sn par exemple. Quel que soit votre choix, le DN sera toujours 

retourne ; 

$attrs_seuls est par defaut a la valeur 0. Cela signifie qu'il retourne pour chaque 

attribut son type et sa valeur. Mettre $attrs_seul s a la valeur 1 signifie que seuls les 

types d'attributs seront retournes, sans les valeurs ; 

$tai 1 1 ejnax represente le nombre de resultats maximal a retourner ; 

$temps_max specifie le temps maximal, en secondes, de duree de la recherche ; 

$deref precise comment les alias doivent etre geres durant la recherche. 

Ce qui donne pour lire les informations inserees grace aux scripts precedents, le script 
lecture _ldap.php : 



fl^j lecturejdap.php 



<?php 

echo "<h3>Lecture dans LDAP</h3>"; 

$ldc = ldap_connect (' localhost' ) 

or die (' impossible de se connecter au serveur LDAP') 

ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

ldap_bind($ldc) 

or die (' authentif ication echouee' ) ; 
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// Liste de toutes les personnes 

$lds = ldap search($ldc, "dc=mon annuaire, dc=org", "sn=*"); 

$ldge = ldap_get_entries ($ldc, $lds); 

echo "Lecture de 1' annuaire<br/>"; 

for ($n=0; $n < $ldge ["count"]; $n++) { 



echo "dn 

echo "en 

echo "sn 
} 



". $ldge[$n] ["dn"] ."<br/>"; 
". $ldge[$n] ["en"] [0] ."<br/>"; 
". $ldge[$n] ["sn"] [0] ; 



ldap_close ($ldc) 
?> 



Modifier une entree 

Un contact ne reste jamais immobile. II change de numero de telephone plusieurs fois 
dans sa vie. II demenage et il change done egalement d'adresse, de code postal et de 
commune, etc. II est done indispensable de pouvoir modifier des entrees de 1' annuaire. 
Pour effectuer toutes ces modifications, une seule fonction est necessaire : 

bool ldapjnodi fy(ressource $id_connexion, chaTne $dn, tableau $entrees) 

Supprimer une entree 

Lorsqu'un compte ne sert plus a rien (depart en retraite d'un employe), supprimer ledit 
compte est la moindre des actions a effectuer arm de garder un repertoire propre et a jour. 
La fonction ldap_delete() permet de supprimer une entree dans un repertoire LDAP : 

bool ldap_delete(ressource $id_connexion, chaTne $dn) 

Observez le script supprimer _contact.php qui effectue la suppression du compte 
ddrape02 : 

^j supprimerjndividu.php 

<?php 

echo "<h3>Suppression du compte ddrape02</h3>" ; 

$ldc = ldap_connect (' localhost' ) 

or die (' impossible de se connecter au serveur LDAP'); 

ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 
$dn = "cn=Manager , dc=mon annuaire, dc=org" ; 
ldap_bind($ldc, $dn, "secret") 

or die ( ' authentif ication echouee' ) ; 
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// Ajouter une organisation : definition des informations 

$info ["en"] = "ddrape02"; 

$rdn = ' cn=' . $info['cn'] . ' , ou=contacts prof essionnels, o=drapeau 

*» suire , c=France, dc=mon annuaire, dc=org' ; 

// Liste de toutes les personnes 
if($ldd = ldap_delete($ldc, $rdn) ) { 

echo 'suppression effectuee avec succes' ; 
} else { 

echo 'echec lors de la tentative de suppression'; 
} 

ldap_close ($ldc) ; 
?> 



Aller plus loin avec LDAP 

Gestion des erreurs 

Comme beaucoup d' extensions PHP, LDAP fournit deux fonctions pour recuperer les 
erreurs: ldap_errno() et ldap_error(). Vous apprendrez egalement a utiliser une 
troisieme fonction qui est ldap_err2str(). 

entier ldap_errno(ressource $id_connexion) retourne le numero d'erreur courant. 
chaTne ldap_error(ressource $id_connexion) retourne le message d'erreur sous 
forme de caracteres. 

chaTne ldap_err2str (entier $errno) retourne le message d'erreur grace au numero 
d'erreur ($errno). 

Le script gestion_erreurs_ldap.php sera beaucoup plus parlant : 

<^jt gestion_erreurs_ldap.php 

<?php 

$ldc = ldap connect (' mauvais serveur' ) ; 

$ldb = ldap_bind($ldc) ; 

if (!$ldb) { 

$numero erreur = ldap errno ( $ldc) ; 

$message erreur = ldap error ($ldc) ; 

$message_erreur de errno = ldap err2str ($numero erreur); 

echo 'numero erreur = ' . $numero erreur .'<br/>'; 

echo 'message erreur = '. $message erreur .'<br/>'; 

echo 'message de errno = ' . $message erreur de errno; 
} else { 
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echo 'connexion au serveur LDAP effectuee avec succes' 



} 

ldap_close ($ldc) ; 

?> 



Liberer la memoire 

Avec PHP, la memoire est automatiquement liberee a la fin du script. Aussi, il est tout de 
meme utile, a chaque fois que possible, de laisser un maximum d'espace memoire libre 
a tout instant. La fonction ldap_free_resul t() effectue la meme action que 
mysql_free_resul t() pour les BDD MySQL. C'est-a-dire qu'elle libere la memoire une 
fois l'operation effectuee. Voici un exemple de l'utilisation de ldap_free_resul t() avec 
le script gestion_memoire.php : 

bool ldap_free_result(ressource $id_resultat) 

$id_resul tat est la variable $ressource a laquelle est affectee la manipulation LDAP. Le 
script gestion_memoire.php en donne un exemple : 

Q&, gestion_memoire.php 

<?php 

/* instructions LDAP */ 

$identif iant_resultat = ldap_delete ($ldc, $dn) ; 

// Liberation de l'espace memoire allouee 

// a 1' execution de la fonction ldap_delete ( ) 

mysql_free result ($identif iant resultat) ; 

/* Autres instructions LDAP */ 

/* Autres instructions */ 
?> 



Les premiers... et les suivants 

first _attribute() 

chaine ldap_first_attribute(ressource $id_connexion, resource $result_entry 
_identifier, int &$ber_identifier) 

Permet de recuperer le premier attribut d'une entree. Tous les autres attributs peuvent etre 
recuperes grace aux fonctions ldap_next_attribute() et ldap_get_attribute(). 
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firstjentryO 

ressource ldap_first_entry(ressource $id_connexion, ressource $result) 

Permet de recuperer la premiere entree d'un annuaire LDAP. Toutes les autres entrees 
peuvent etre recuperees grace aux fonctions ldap_next_entry() et ldap_get_entries(). 

first _reference() 

ressource ldap_first_reference (ressource $id_connexion, ressource $result) 

Permet de recuperer la premiere reference d'un annuaire LDAP Toutes les autres 
references peuvent etre recuperees grace aux fonctions ldap_next_reference() et 
ldap_get_reference(). 

5.4 Cas pratique : gerer ses contacts 

Bien entendu, les exemples cites precedemment ne sont pas anodins. lis vous ont permis 
de preparer le cas pratique. Maintenant que l'arbre LDAP est fonctionnel, il ne reste plus 
qu'a creer les formulaires qui permettent, entre autres, d'ajouter/modiner/supprimer un 
contact. Vous remarquerez que lors du script d'insertion d'un individu, un identifiant et 
un mot de passe ont ete crees pour l'individu arm que le cas pratique de ce chapitre puisse 
s'adapter au plus grand nombre de situations possibles. C'est-a-dire que si vous desirez 
simplement creer un annuaire de contacts, vous pouvez eviter la creation d'un mot de 
passe pour chaque utilisateur (individu). Mais s'il s'agit d'un annuaire de contacts pour 
un site Internet (ou toute autre application), et que chaque contact doit pouvoir se 
connecter a un back-office, alors ce cas pratique sera egalement fonctionnel. 

Le script ajouter_un_contact.php presente un formulaire qui vous permet d'ajouter un 
nouvel individu. II est simple et reprend en grande partie le script ajouterJ.ndividu.php 
etudie precedemment : 

*fy ajouter_entree.php 

<html> 
<head> 
<title>Aj outer un contact</title> 

</head> 

<body> 

<hl>Ajouter un contact dans 1' annuaire</hl> 

<?php 
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if (isset ($_POST[' submit' ] ) && $_POST [ ' nom' ] != "){ 
$dn = ' cn=Manager , dc=mon annuaire, dc=org' ; 
$passldap = ' secret' ; 

$ldc = ldap_connect ( ' localhost' ) 

or die (' Impossible de se connecter au serveur LDAP'); 

// Voici la ligne qui evite le message de Warning 
ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3) ; 

// Authentif ication au serveur LDAP avec ldap bind() 
// Authentif ication avec identifiant 
$ldb = ldap_bind($ldc, $dn, $passldap) 

or die ( 'Authentif ication au serveur LDAP echouee' ) ; 
// Aj outer une organisation : definition des informations 
$info ["en"] = $_POST [' identifiant' ] ; 
$prenom = ucfirst($ POST [' prenom' ]) ; 
$nom = strtoupper ($_POST ['nom' ] ) ; 

$info["sn"] = $_POST [' prenom' ] .' '. $_POST [ ' nom' ] ; 
$inf o [ "userPassword" ] = $ POST ['mot de passe']; 
$info ["objectClass"] [0] = "person"; 
$info['objectClass' ] [1] = 'top'; 

$rdn = ' cn=' . $info['cn'] . ' , ou=contacts prof essionnels, o=drapeau 
** suire, c=France, dc=mon annuaire, dc=org' ; 

// Aj outer les donnees dans 1' annuaire 

$r = ldap_add ($ldc, $rdn, $info) ; 

if ($r) { 

echo 'donnees ajoutees : '. $rdn .'<br/>'; 

} else { 

echo 'ajout : ' . $rdn .'<br/>dans annuaire LDAP echoue<br/>' ; 



ldap_close ($ldc) 



} 
?> 



Informations du contact<br/> 
<form action="#" method="POST"> 



Identifiant <input type="text" name="identif iant" /> 

Mot de passe <input type="password" name="mot de passe" /><br/> 

Nom <input type="text" name="nom" /> 

Prenom <input type="text" name="prenom" /><br/> 
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<input type="submit" name=" submit" value="Valider" /><br/> 
</f orm> 

</body> 
</html> 

Le script ajouter_un_contact.php presente un formulaire qui contient des champs de texte 
pour que vous puissiez saisir les informations du contact et un bouton Valider arm de les 
inserer dans LDAP. Gardez en memoire, qu'avec LDAP, vous ne pouvez pas saisir de 
caracteres accentues. Cela signifie que le prenom Stephane devra etre saisi "Stephane" 
(sans les guillemets, cela va de soi). 

L'interet de creer un annuaire de contact est de pouvoir retrouver un contact tres 
rapidement grace a une recherche ciblee par un utilisateur. Le script lister_contacts.php 
montre un exemple de recherche d'un ou plusieurs contacts sur le sn : 



J^jt lister_entrees.php 



<html> 
<head> 
<title>Af ficher la liste</title> 

</head> 

<body> 

<form action="#" method="POST"> 

Rechercher <input type="text" name="rechercher" size="30" /> 

<br/> 

<input type="submit" name=" submit" value="Lancer la recherche" /> 

</f orm> 

<br/> 

<?php 

if (isset ($_POST[' submit' ] ) && $_POST [' rechercher' ] != "){ 

$rechercher = trim (htmlspecialchars (strip tags ($ POST [' rechercher' ]) , 

*■► ENT_QUOTES) ) ; 

echo "<h3>Resultat de la recherche</h3>" ; 

$ldc = ldap_connect (' localhost' ) 

or die (' impossible de se connecter au serveur LDAP' ) ; 

ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3); 

ldap_bind($ldc) 

or die ( ' authentif ication echouee' ) ; 



// Liste de toutes les personnes 
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$lds = ldap search ($ldc, "dc=mon annuaire, dc=org" , "sn=$rechercher*" ) 
$ldge = ldap_get_entries ($ldc, $lds); 
echo "Lecture de 1' annuaire<br/>" ; 

for ($n=0; $n < $ldge ["count"]; $n++) { 

echo "dn : ". $ldge [$n] ["dn" ] ."<br/>"; 

echo "en : ". $ldge [$n] ["en" ] [0] ."<br/>"; 

echo "sn : ". $ldge [$n] ["sn" ] [0] ; 



ldap_close ($ldc) ; 
} 

?> 

</body> 

</html> 

Bien entendu, il peut etre necessaire de supprimer un contact. Par exemple, un employe 
quitte l'entreprise pour une quelconque raison (fin de contrat, demission, licenciement, 
etc.), et il est done bien utile de pouvoir supprimer son compte arm de ne pas laisser dans 
1' annuaire LDAP des comptes inactifs. Regardez le script supprimer _entree.php qui 
effectue cette operation a merveille : 



flW supprimer_entree.php 



<html> 
<head> 
<title>Supprimer une entree</title> 

</head> 

<body> 

<form action="#" method="POST"> 

Rechercher <input type="text" name=" supprimer" size="30" /> 

<br/> 

<input type=" submit" name="submit" value="Lancer la recherche" /> 

</f orm> 

<br/> 

<?php 

if (isset ($_POST[' submit' ] ) && $_POST [' supprimer' ] != ''){ 

$supprimer = trim (htmlspecialchars ( strip tags($ POST [' supprimer' ]) , 

*+ ENT_QUOTES) ) ; 

echo "<h3>Supprimer une entree</h3>" ; 

$ldc = ldap_connect ( ' localhost' ) 

or die (' impossible de se connecter au serveur LDAP' ) ; 
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ldap_set_option ($ldc, LDAP_OPT_PROTOCOL_VERSION, 3 ) ; 
$dn = "cn=Manager , dc=mon annuaire, dc=org" ; 
ldap_bind($ldc, $dn, "secret") 

or die ( ' authentif ication echouee' ) ; 

// Ajouter une organisation : definition des informations 

$rdn = ' cn=' . $supprimer . ' , ou=contacts prof essionnels, o=drapeau 

*» suire, c=France, dc=mon annuaire, dc=org' ; 

// Liste de toutes les personnes 
if($ldd = ldap_delete($ldc, $rdn) ) { 

echo 'suppression effectuee avec succes' ; 
} else { 

echo 'echec lors de la tentative de suppression'; 
} 

ldap_close ($ldc) ; 
} 
?> 

</body> 
</html> 

Vous voila maintenant equipe d'une application sommaire pour gerer vos contacts, 
employes et autres personnes grace a un annuaire LDAP. Comme pour tous les autres 
chapitres, arm de satisfaire au plus grand nombre, les cas pratiques sont volontairement 
basiques et tres ouverts a toutes evolutions ulterieures en fonction de vos besoins. Tres 
utiles dans cet exemple pour des authentifications, vous pouvez toujours ajouter des 
informations supplementaires pour chaque individu comme par exemple une adresse 
e-mail ou encore un numero de telephone. Nous vous souhaitons ainsi de faire de belles 
decouvertes dans le monde de PHP/LDAR Vous pouvez passer maintenant a un chapitre 
tout autant utile et interessant qui est l'abstraction d'acces aux bases de donnees. 

5.5 Check-list 

Au cours de ce chapitre, vous avez pu approcher les techniques de gestion d' annuaire 
avec LDAP. Nous avons vu notamment : 

*/ l'installation d'OpenLDAP sous Windows et Linux Debian ; 

*/ la conception d'une arborescence LDAP ; 

*/ la creation de 1' arborescence LDAP par le biais de PHP ; 

>/ l'ajout, la modification et la suppression d'une entree dans 1' annuaire LDAP ; 

<y des fonctions complementaires comme la gestion des erreurs, ou la memoire. 
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PDO [PHP Data Object) est une bibliotheque 
programmee en C pour PHP. Son avantage par 
rapport a d'autres bibliotheques de bases de donnees 
telles que PEAR::DB ou AdoDB, qui sont les plus connues, 
est que PDO est beaucoup plus rapide par rapport aux 
deux autres qui sont programmees en PHP et non en C 
comme Test PDO. 
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6.1 Installation 
Windows 

Installer PDO sous Windows est tres simple. Editez le fichier php. ini et decommentez la 
ligne ;extension=php_pdo.dl 1 en enlevant le point-virgule ( ; ) en debut de ligne. Faites 
de meme pour les extensions des pilotes des SGBD (Systeme de gestion de bases de 
donnees) que vous desirez utiliser : extension=php_pdo_*.dl 1 ou * est le nom du pilote 
du SGBD (par exemple extension=pdo_php_mysql .dll). Redemarrez le serveur web. 

Linux 

L'exemple cite ici est pour Debian Etch. Les autres versions ne doivent guere etre 
beaucoup plus differentes. 

Par le gestionnaire de paquets apt-get 

Avec les sources 

Telechargement 

Allez sur le site ftp://ftp.fr.postgresql.org/latest et telechargez la version adequate. Lors de la 
redaction de ce chapitre, la derniere version {latest) etait postgresql-8.2.5 .tar.gz. Ensuite, 
placez-vous en root pour la suite des manipulations. 

Verification de l' archive telechargee 

Pour cet exemple, les sources ont ete telechargees dans le repertoire /usr/local/src. 

# cd /usr/local/src 

Verification du checksum 

# md5sum postgresql-8 . 2 . 5 . tar . gz 

Si le checksum est OK, alors l'installation peut se poursuivre. 

Decompression du fichier 

# tar -xzvf postgresql-8 . 2 . 5 . tar .gz && cd postgresql-8.2.5 
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Configuration 

# ./configure --pref ix=/usr/local/pgsql 

Compilation 

# make && make install 

Demarrage 

# cd /usr/local/pgsql 

# adduser postgres 
Suivre les indications 

# mkdir /usr/local/pgsql/data 

# chown postgres /usr/local/pgsql/data 

# su - postgres 

postgres@domus : ~$ /usr/local/pgsql/bin/inidb -D /usr/local/pgsql/data 

success 

II y a deux methodes pour demarrer le serveur PostgresSQL. Soit en avant-plan avec la 
commande suivante : 

postgres@domus : ~$ /usr/local/pgsql/bin/postgres -D \ 
/usr/local/pgsql/data 

Soit en arriere-plan avec la commande suivante : 

postgres@domus : ~$ nohup /usr/local/pgsql/bin/postgres -D \ 

/usr/local/pgsql/data </dev/null »server.log 2>&1 </dev/null 

Pour arreter le serveur en arriere-plan, il surTit d'executer la commande : 

postgres@domus : ~$ kill 'cat /usr/local/pgsql/data/postmaster .pid' 

Et il ne reste plus qu'a activer PDO dans PHP Les tests ont ete effectues sur Debian Etch 
avec PHP6 que vous pouvez telecharger (les sources) sur http://snaps.php.net/. A l'heure oil 
ces lignes sont redigees, la version PHP6 n'est pas encore sortie officiellement. II est 
necessaire que PHP soit compile avec les options — wi th-pgsql =/DIR et 
— wi th-pdo-pgsql =/DIR. 
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Verifier 1' installation 



Executez votre script favori, phpinfo.php, qui contient la fonction phpinfoQ. Et voici le 
resultat : 





pdo_pgsql 






PDO Driwer for PostureSQL 


enabled 






PostgreSQLf lihpq) Version 


8.2.3 






Module version 


1.0.2 






Revision 


$ld:pdo_pgsql.c,v1.7.2.11.2.1 2007/01/01 09:36:05 Sebastian Exp $ 






pgsql 






PostgreSQL Support 


enabled 






PostgreSGLf lihpq) Version 


8.2.3 






Multihyte character support 


enabled 






SSL support 


disabled 






Active Persistent Links 









Active Links 















Directive 


Local Value 


Master Value 






pgsql.allowjrersistent 


On 


On 






pus(|l.auto_resetj>ersistenit 


Off 


Off 






pusql.iunorejiotice 


Off 


Off 






pusql.loujiotice 


Off 


Off 






pusql.maxjinks 


Unlimited 


Unlimited 






pgsql.max_persistent 


Unlimited 


Unlimited 











Fig. 6.1 : PostgreSQL reconnu par PHP 

6.2 UtiliserPDO 

L'interet d'utiliser PDO reside dans le fait qu'avec PDO, quel que soit le SGBD que 
vous utilisez, les fonctions sont toujours les memes. Vous pouvez entierement vous 
concentrer sur les requetes SQL. De plus, en utilisant au maximum les normes SQL2 
ou SQL3, vous supprimerez (presque) toute dependance au SGBD utilise et cela 
facilitera une migration vers un autre SGBD si cela s'avere necessaire un jour. Les 
SGBD ayant tous leurs forces et leurs faiblesses, avec PDO vous pouvez vous 
connecter a plusieurs SGBD differents arm de consacrer chaque partie d'une application 
au SGBD qui lui soit le plus competent. 
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Se connecter/deconnecter 

Connexion 

Se connecter a PDO peut paraitre complexe, voire un peu deroutant pour quelqu'un ay ant 
utilise MySQL durant des annees avec les fonctions natives (mysql_*()). En fait, il s'agit 
juste d'un petit (vraiment petit) temps d'adaptation et de comprendre ce qu'est le DSN 
(Data Source Name). 

La connexion se fait toujours de la meme maniere quel que soit le SGBD auquel vous 
desirez acceder. Seuls les parametres passes dans le constructeur varient. Pour tous les 
SGBD, le premier parametre contient les DSN et des informations complementaires. 

Connexion MySQL 

<^£ connexion_mysql.php 

<?php 

$host = 'localhost'; 

$user = ' root' ; 

$pass = 'xxxxxxx'; 

$db = 'test' ; 

$oPDOLink = new pdo ( "mysql : host=$host; dbname=$db" , $user, $pass) ; 
if ( ! $oPDOLink) { 

echo 'Connexion au serveur MySQL impossible'; 
} else { 

echo 'Connexion au serveur MySQL effectuee avec succes' ; 
} 

$oPDOLink = NULL; 
?> 



Connexion PostgreSQL 



*^£ connexion_pgsql.php 


<?php 




$host = 


' localhost' ; 


$user = 


'postgres' ; 


$pass = 


' xxxxxxx' ; 
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$db = 'test'; 

$oPDOLink = new pdo ( "pgsql : host=$host user=$user password=$pass" ) 
if ( !$oPDOLink) { 

echo 'Connexion au serveur PostgreSQL impossible'; 
} else { 

echo 'Connexion au serveur PostgreSQL effectuee avec succes' ; 
} 

/* Instructions */ 

$oPDOLink = NULL; 

?> 



(J) Les points-virgules comme separateurs 

Vous verrez souvent dans les exemples, sur Internet ou dans des ouvrages specialises, les parametres du 
DSN separes par des espaces (comme indique dans le script connexion_pgsql.php en ce qui concerne 
PostgreSQL. Afin de respecter une norme au sein de PDO, il est preferable de toujours utiliser les 
points-virgules ( ; ) comme separateurs. 



Deconnexion 

La deconnexion est sans commentaires tellement celle-ci est simple. 

$oPDOLink = NULL; 

PDO et les exceptions 

PDO est constitute de trois classes qui sont PDO, PDOStatement et PDOException. Cela 
signifie que PDO gere son propre systeme d'exceptions meme si la classe PDOException 
herite de la classe generique Exception de PHP 

Pour simplifler les exemples suivants, deux nchiers vont etre crees et qui seront appeles 
par un require_once() dans les exemples. Un sera consacre a MySQL (connect _mysql 
.inc.php) : 



J^j connect_mysql. inc.php 

<?php 

$host = 'localhost'; 

$user = ' root' ; 
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$pass = 'xxxxxxx'; 






$db = 'test' ; 






try { 






$oPDOLink = new pdo ( "mysql : host=$host ; dbname=$db" , 


$user, 


$pass) ; 


} catch (Exception $e) { 






print (' Erreur '. $e->getMessage ( ) ) ; 
} 






?> 







Et 1' autre a PostgreSQL (connect_pgsql.inc.php) : 



*« 


:onnect_pgsql.inc.php 






<?php 








$host 


= ' localhost' ; 






$user 


= 'postgres' ; 






$pass 


= ' xxxxxxx' ; 






$db = 


'test' ; 






try { 








$oPDOLink = new pdo ( "mysql : host=$host ; dbname=$db", 


$user , 


$pass) ; 


} catch (Exception $e) { 






print (' Erreur '. $e->getMessage ( ) ) ; 
} 






?> 









Manipulations des donnees 

Executer des requetes 

II y a deux methodes pour executer des requetes avec PDO qui sont exec() et query (). 
Cependant, il y a une difference entre ces deux fonctions qui ne sont pas anodines. exec() 
retourne un entier qui represente le nombre de lignes affectees par la requete. query () 
retourne soit un objet de type PDOStatement, soit un booleen selon les parametres qui sont 
passes dans la fonction. II existe une syntaxe possible pour exec() et quatre autres pour 
query() : 

int exec(string statement); 

PDOStatement PDO: :query(chaine statement); 



213 



Gerer les donnees avec PDO 



bool PDO::query(chaine statement, entier PDO: :FETCH_COLUMN, entier 

col_no) ; 

bool PDO: :query(chaine statement, entier PDO: :FETCH_CLASS, chaine class, 

tableau ctoargs); 

bool PDO::query(chaine statement, entier PDO: :FETCH_INTO, objet object); 

Les differences entre ces cinq syntaxes seront decrites un peu plus loin dans ce chapitre. 

A titre d'exemple, creez dans une base de donnees nommee test une table nominee users 
qui contient les colonnes use_id, use_login, use_password, use_prenom et use_nom et 
inserez-y plusieurs lignes. Faites ceci avec MySQL et PostgreSQL : 



J^jt tablejogins.sql 



CREATE TABLE logins ( 

login char (15) NOT NULL, 
pass char (80) NOT NULL, 
prenom CHAR (30) NOT NULL, 
nom CHAR (30) NOT NULL, 
PRIMARY KEY (login) 



INSERT INTO logins VALUES (' ddrapeau' , SHA1 ( ' xxxxxxxx' ) , 

' david' , ' drapeau' ) ; 
INSERT INTO logins VALUES (' fsuire' , SHA1 (' xxxxxxxx' ) , 

' f rederic' , ' suire' ) ; 



Lire dans une table 

Vous allez maintenant afficher le contenu de la table logins avec MySQL, PostgreSQL, 
PDO MySQL et PDO PostgreSQL. Vous verrez ainsi la difference entre l'utilisation des 
drivers natifs de chaque SGBD et de celle de PDO (mysql et pgsql). 

Drivers natifs 

Utiliser les drivers natifs oblige a connaitre les fonctions typiques au SGBD utilise. Par 
exemple, vous utilisez MySQL depuis des annees et on vous demande pour un projet 
d'utiliser PostgreSQL : vous etes dans la necessite d'etudier PostgreSQL et cela va vous 
prendre beaucoup de temps et d'energie. Heureusement, les deux se ressemblent 
beaucoup mais ont chacun des particularites et des differences. 
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MySQL 



^* lire_logins_mysql.php 

<?php 

$host = 'localhost'; 
$user = ' root' ; 
$pass = 'xxxxxx'; 
$db = 'test' ; 
$table = 'logins'; 

$link = mysql_connect ($server, $user, $pass); 
mysql_select_db ($db) ; 

$request = "SELECT login, prenom, nom FROM ". $table; 
$result = mysql_query ($request) ; 

while ($ligne = mysql_fetch array ($result) ) { 

echo $ligne [' login' ] .' '. ucfirst ($ligne [' prenom' ] ) .' ' 
**■ strtoupper ( $ligne [ ' nom' ] ) . '<br/>'; 

} 

mysql close ($link) ; 
?> 



PostgreSQL 



#£ lire. 


Jogins_postgresql.php 










<?php 












$host = 


' localhost' ; 










$user = 


'postgres' ; 










$pass = 


' xxxxxx' ; 










$db = 't 


est' ; 










$table = 


' logins' ; 










$link = 


pg connect ( "host=$host db 


iame= 


=$db user 


=$user password 1 


= $pass" ) ; 


$request 


= "SELECT login, prenom, 


nom 


FROM " . 


$ table; 




$result 


= pg query ($request) ; 










while ($1 


igne = pg fetch array ($result) ) { 
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echo $ligne [' login' ] .' '. ucf irst ($ligne [' prenom' ] ) .' '. 
** strtoupper ( $ligne [ ' nom' ] ) .'<br/>'; 

} 

pg_close ($link) ; 

?> 

PDO 

En utilisant PDO, vous n'avez plus besoin de modifier toutes les fonctions dans tous les 
scripts. Vous utilisez les fonctions PDO avec MySQL. Et si pour une mission, vous devez 
utiliser un autre SGBD que supporte PDO, vous n'aurez pas a apprendre les fonctions de 
1' autre SGBD et continuerez a utiliser les fonctions PDO. Done, le temps et l'energie 
economises sont immenses. 



pdojnysql 



^j lire_logins_pdo_mysq 


.php 












<?php 

// Definition des variables 

$host = 'localhost'; 












$user = ' root' ; 














$pass = 'xxxxxxx'; 














$dbname ='test'; 
$table = 'logins'; 














$pdc = new pdo ("mysql : 
or die ( "Erreur<br/>" 


hostname=$ho 
. $e->getMe 


st;db 
ssage 


name= 
0); 


=$dbname" 


, $user, $pass) 


$sql = "SELECT login, prenom, nom FROM 

$result = $pdc->query ($sql) ; 

while ($ligne = $result->fetch ( ) ) { 

echo $ligne [' login' ] .' '. ucf irst ($1 
*■► strtoupper ( $ligne [' nom' ] ) .'<br/>'; 

} 


". $ table; 
igne [ ' prenom' 


]) •' ' • 


$pdc = NULL; 
?> 
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pdo_pgsql 

On vous demande de faire la meme chose avec PostgreSQL depuis la migration de la base 
de donnees ? C'est tres facile. La seule chose a modifier dans le script est la ligne 
suivante : 

$pdc = new pdo("mysql :hostname=$host;dbname=$dbname", $user, $pass); 

Et il vous suffit de placer dans les parentheses : 

"pgsql :host=$host;dbname=$dbname;user=$user;password=$pass" 

Ce qui donne, pour le script complet : 

^^ lire_logins_pdo_pgsql.php 

<?php 

// Definition des variables 

$host = ' localhost' ; 

$user = 'postgres'; 

$pass = 'xxxxxx'; 

$dbname ='test'; 
$table = ' logins' ; 

$pdc = new 

*"► pdo ( "pgsql : host = $ host; dbname=$dbname; user=$user;password=$pass") 
or die ( "Erreur<br/>" . $e->getMessage ( ) ) ; 

$sql = "SELECT login, prenom, nom FROM ". $table; 
$result = $pdc->query ($sql) ; 
while ($ligne = $result->fetch ( ) ) { 

echo $ligne [' login' ] .' '. ucfirst ($ligne [' prenom' ] ) .' '. 

**■ strtoupper ( $ligne [ ' nom' ] ) .'<br/>'; 

} 

$pdc = NULL; 
?> 

Bien stir, il faut aussi remplacer les valeurs des variables si celles-ci sont differentes. C'est 
pour cette raison que dans beaucoup d'ouvrages, meme de tres bonne qualite, il vous est 
souvent conseille de creer un fichier defines.inc.php dans lequel l'auteur vous conseille de 
definir toutes les constantes du projet ainsi que les parametres de connexion au SGBD 
concerne et de definir dans ce meme fichier de configuration le DSN pour l'utilisation de 
PDO. Ensuite, vous appelez ce fichier dans vos scripts de la facon suivante : 
requi re_once ( ' def i nes .inc. php ' ) ; . 



217 



Gerer les donnees avec PDO 



Cette fa9on de faire est deconseillee car a chaque fois que vous allez appeler ce fichier, 
que ce soit par include(), include_once(), require() ou require_once(), toutes les 
constantes seront automatiquement definies et pas uniquement celles que vous utiliserez 
dans le fichier appelant. Done, si pour un gros projet, vous avez dans ce fichier deux cents 
ou trois cents constantes, voire plus... Cela prend de la place en memoire et en outre 
allonge largement le temps d'execution dans le script. II suffit d'utiliser les fonctions de 
tracing avec Xdebug et de sauvegarder les resultats dans un fichier de trace. C'est 
deconcertant ! Evidemment, ce serait trop fastidieux de definir les constantes dans tous les 
fichiers PHP. Imaginez un projet avec cent fichiers et tous utilisant l'acces aux bases de 
donnees ! S'il est necessaire de changer le nom d'une base de donnees, cela signifie 
autant de fichiers a modifier. Ce n'est vraiment pas pratique. 

La methode ici mise en place est une classe qui fonctionne comme le fichier defines. inc 
.php a la difference que quand on appelle la classe par i ncl ude(), ou l'une des trois autres 
methodes, rien n'est defini par avance. Cela ne prend done aucune place en memoire. II 
suffit ensuite d'instancier un objet de la classe, et seules les methodes de classe utilisees 
prendront de la place en memoire. 



*Vj ClassDefine.php 



<?php 
/** 

* /include/ClassDef ine . php 
• 

* Cette classe definit les variables qui sont considerees 

* comme statiques Certaines changent lorsqu'on change 

* d' environnement d' hebergement 

* (la plupart gardent la meme valeur) 
*/ 

class ClassDefine { 

// Definitions des variables de classe 
private $ server = ' localhost' ; // Serveur SQL 
private $_user = 'postgres'; // Utilisateur SQL 
private $ password = 'xxxxxx'; // Password SQL 
private $_dbname = 'test'; // Nom de la BDD PostgreSQL 
private $ tablename = null; 

/** Definitions des methodes **/ 

// Constructeur 

public function construct (){ } 
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// Destructeur 

public function destruct(){} 

public function getSQLServer ( ) { 

return $this-> server; 
} 

public function getSQLUser ( ) { 

return $this-> user; 

} 

public function getSQLPassword ( ) { 

return $this-> password; 
} 

public function getSQLDatabase ( ) { 

return $this-> dbname; 
} 

public function getSQLTable ($tablename) { 
return $this-> tablename = $tablename; 
} 
} 

Et voici a present un exemple de connexion pour un fichier PHP appelant cette classe et 
qui utilise PostgreSQL : 

&& connexion_via_ClassDefine.php 

<?php 

require once ( ' ClassDef ine . php' ) ; 

$D = new ClassDef ine () ; 
$host = $D->getSQLServer () ; 
$dbname = $D->getSQLDatabase ( ) ; 
$user = $D->getSQLUser () ; 
$password = $D->getSQLPassword ( ) ; 

$oLink = new PDO ( "pgsql : host=$host dbname=$dbname 
user=$user password=$password" ) ; 

/** Instructions **/ 
?> 



SIS 
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Ecrire dans une table 

Vous venez de voir dans la section precedente Lire dans une table a quel point la meme 
action dans deux SGBD differents est identique. Changer de SGBD demande de changer 
uniquement les parametres de connexion dans le constructeur et leurs valeurs. Rien 
d' autre. Ce qui prouve bien que vous pouvez vous concentrer uniquement sur le code 
SQL. Du fait de cette simplicite, et du fait aussi que dans beaucoup de manuels, PDO est 
explique avec MySQL, tous les exemples qui vont suivre seront ecrits avec 
PDO PostgreSQL. Cela vous fournira des exemples et des informations complementaires. 

Dans les exemples de lecture dans une table avec PDO, vous avez utilise la fonction 
query () et non exec(). Pourquoi ? Parce que dans le cas d'une lecture ou du contenu est 
retourne, les donnees se trouvant dans la table SQL repondent aux criteres de la requete 
SQL SELECT. 

Contrairement a un SELECT, lors d'une ecriture dans la table SQL (INSERT), il n'y a pas 
de contenu de retourne mais seulement une valeur de retour pour signaler si tout s'est 
bien passe ou non. II faudra done utiliser la fonction exec() et non query (). 

^j ecrire_logins_pdo_pgsql.php 

<?php 

// Definition des variables 

$host = ' localhost' ; 

$user = 'postgres'; 

$pass = 'xxxxxx'; 

$dbname ='test'; 
$table = ' logins' ; 

$pdc = new pdo ("pgsql : host=$host ; dbname=$dbname; user 
*» =$user;password=$pass" ) 

or die ( "Erreur<br/>" . $e->getMessage ( ) ) ; 

$sql = "INSERT INTO logins VALUES (' rroberto' , ' passroberto' , 'rinaldo', 

*» ' roberto' ) " ; 

$result = $pdc->exec ($sql) ; 

if ( !$result) { 

echo ' Insertion dans la table echouee' ; 
} else { 

echo 'Insertion dans la table effectuee avec succes' ; 
} 
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$pdc = NULL; 
?> 

Remplacez exec() par query () pour l'ecriture et le message "Insertion dans la table 
echouee" apparaitra dans le navigateur. 

Utiliser les exceptions 

La version 5 de PHP integre la gestion des exceptions par defaut. Si vous ne maitrisez pas 
encore ce domaine, etudiez-le. Utiliser la fonction die(), tel que cela a ete fait jusqu'a 
present, n'est vraiment pas un gage de qualite, ni de securite. Cela demontre meme une 
certaine incompetence tout comme 1' usage de la fonction md5() alors qu'il a ete prouve 
que des collisions etaient possibles en utilisant cette fonction de cryptage. Mieux vaut 
utiliser la fonction shal() tout aussi simple a utiliser et beaucoup plus sure. 

PDO contient trois classes dont deux deja utilisees et une troisieme que vous allez 
decouvrir maintenant. II s'agit de la classe PDOException qui herite de la classe Exception 
de PHP Analysons la classe PDOException : 

La classe PDOException contient six methodes que vous pouvez utiliser et qui sont les 
suivantes : 

getMessage() retourne le code erreur et le message d'erreur de PDO. 

getCode() retourne la valeur retournee par le code (c'est-a-dire la valeur 

numerique 0). 

getFile() retourne le nom du fichier (chemin complet) ou a ete generee l'erreur. 

getLine() retourne le numero de ligne du fichier ou a ete generee l'erreur. 

getTrace() retourne le type contenant le tracing (Array). 

getTraceAsString() retourne les memes informations que getCode(), getFile(), 

getLine() associees avec, en plus, la fonction PDO qui a genere l'erreur. 

Pour ceux qui utilisent deja la classe Exception, il est facile de remarquer qu'elles sont 
identiques. PDOException recupere les methodes de la classe Exception et definit ses 
propres codes et messages d'erreurs. 

Executez le script exceptions _pdo.php dans votre navigateur et regardez le resultat par 
vous-meme. Vous comprendrez tout de suite. 



$^£ exceptions_pdo.php 

<?php 

$host = ' localhost' ; 
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$user = 'postgres'; 

$pass = 'mauvais password'; 

$db = 'test'; 

try { 

$pdc = new pdo ( "pgsql :host=$host;dbname=$db;user=$user; 
password=$pass" ) ; 

echo 'connexion reussie' ; 
} catch (PDOException $e) { 

echo 'getMessage : '. $e->getMessage ( ) . '<br/>'; 



echo ' getCode 
echo 'getFile 
echo 'getLine 



. $e->getCode () .'<br/>'; 

. $e->getFile () .'<br/>'; 

. $e->getLine () .'<br/>'; 
echo 'getTrace : '. $e->getTrace ( ) .'<br/>'; 
echo ' getTraceAsString : <pre>' . $e->getTraceAsString () 
**■ . '</pre><br/>' ; 



$pdc = NULL; 
?> 



getMessngel I SQLSTATE[08006] [7] FATAL: password authentication failed for user "postgres' 1 

getCodeO : 

gMtFU^lj ' '.' ':::iju[i']iil-': :'■ i7iiLia:r:jli]'':l :i M ''r::':r[ti- ii:j ■ ■■ [lip 

getLiiieO : 11 

getTraceO : 

Array 
[ 

[0] => Array 
( 

[file] -> C:\ xanipp\ htdccs\ dynamise s_php\ chap0 5\ except ions_pdo . php 
[line] => 11 

[function] => construct 
[class] => PDO 
[type] -> -> 
[args] -> Array 
( 

[0] => pgsql : host=localhost; dbname = test; user = postgres; passoierd^ioauvais password 
) 

) 

) 

getTraceAsString^ > 

#0 C : \ xampp\ lit doc s\ dynamise s_php\ chap0 6\ except ions_pdo . php (11) : PDO-> construct ( ' pgsql: ho st=loca. . . 

#1 {main} 



Fig. 6.2 : Les exceptions PDO 
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6.3 Check-list 

Dans ce chapitre, nous avons vu : 

>/ 1' installation PostgreSQL sur Windows et Linux ; 

>/ les connexions via PDO ; 

*/ comment ecrire une classe de connexion ; 

»/ comment utiliser des fonctions PDO ; 

>/ comment utiliser les exceptions. 
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Grace a PHP et a certaines extensions, comme les 
deux qui vont etre expliquees dans ce chapitre, il est 
possible de supprimer une fonction dangereuse le temps 
de I'execution d'un script et de supprimer ainsi une fai le 
de securite. Cela, sans rien modifier en dur dans les 
fichiers .php et en quelques lignes de code seulement. 
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7. 1 Classkit : dynamiser vos classes 

Classkit est une extension PHP qui permet d'agir dynamiquement sur les classes. Les 
fonctionnalites sont limitees, cependant, vous pouvez tout de meme ajouter 
dynamiquement une methode dans une classe et meme importer de nouvelles definitions 
de classe d'un fichier. Vous pouvez egalement renommer, copier, supprimer et redefinir 
dynamiquement les methodes d'une classe. Comme pour beaucoup d'extensions, pour 
installer Classkit sous Windows (avec XAMPP en tout cas), vous avez juste a 
decommenter la ligne dans le php.ini et a redemarrer Apache. Puis, vous ouvrez votre 
superprogramme qui contient la ligne de code magique <?php phpinfo() ;?> et la, vous 
devriez voir un cadre consacre a 1' extension Classkit. 





classkit 




classkit support 


enabled 


version 


0.4 





► Fig. 7.1 : 

L'extension Classkit 
activee 



Classkit ne contient aucune directive a placer dans le php.ini. Tout se passe dans le code 
PHP. Voici un premier exemple dans lequel une methode est renommee via Classkit. Tout 
d'abord, il est necessaire de definir une classe. Vous pouvez utiliser la classe definie dans 
le script classe _UneClasse.php. Observez bien le nom de la methode. 

&q, classeJJneClasse.php 

<?php 

class UneClasse { 

function construct (){ } 

function destruct ( ) { } 

public function uneMethode ($argl, $arg2, 

$defautlArg = 'Bonjour') { 
$salut = $defautlArg .' ' . $argl .' ' . $arg2; 

return $salut; 

} 
} 
?> 
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Vous pouvez voir que l'unique methode definie dans cette classe se nomme uneMethode () 
et qu'elle comprend trois arguments dont le troisieme est optionnel puisqu'une valeur par 
defaut lui a ete affectee. 

Les fonctions de Classkit 

Renommer une methode 

Maintenant, nous allons utiliser la methode cl asski t_method_rename () arm de renommer 
uneMethodeQ pour lui donner le nouveau nom suivant : laNouvel leMethodeQ. 

bool cl asski t_method_rename(chaine $nom_classe, 

chaTne $nom_methode, chaTne $nouveau_nom_methode) 

cl asski tjnethode_rename() prend trois arguments. Le premier ($nom_cl asse) est le nom 
de la classe dans laquelle se trouve la methode ($nom_methode) a renommer. Le deuxieme 
argument ($nom_methode) est le nom de la methode a renommer et le troisieme argument 
($nouveau_nomjnethode) est le nouveau nom que Ton va justement donner a la methode 
ciblee au deuxieme argument, cl asski t_method_rename() retourne true en cas de succes 
et false en cas d'echec. Le script renommer _methode.php montre un exemple qui 
renomme dynamiquement une methode : 



fet ck_renommer_methode.php 



<?php 

// On inclut le fichier dans lequel on a defini la classe 

// et la methode que l'on va renommer 

requireonce ( ' classe_UneClasse . php' ) ; 

// On instancie un objet de la classe 
$CCK = new UneClasseO ; 

// Avant de renommer, on appelle avec le nom d'origine 

echo '<b>appel avec le nom dVorigine :</b> ' ; 

echo $CCK->uneMethode ('David' , ' DRAPEAU' ) . ' <br />' ; 

// Renommer la methode uneMethode ( ) 
// qui va s'appeler maintenant laNouvelleMethode ( ) 
$renommer = classkit method rename (' Uneclasse' , 
' uneMethode' , ' laNouvelleMethode' ) ; 
if ($renommer) { 

echo '<bxfont color="blue"> 

methode renommee avec succes 
</f ontx/b><br/>' ; 
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} else { 

echo ' <bxf ont color="red"> 

impossible de renommer la methode 
</fontx/bxbr/>' ; 
} 

// Puis on utilise la methode renommee precedemment 

// en utilisant son nouveau nom 

echo '<b>appel avec le nouveau nom : </b>' ; 

echo $CCK->laNouvelleMethode ('David' , ' DRAPEAU' ) .'<br/>' 

// Puis on appelle a nouveau par le nom d' origine 
echo '<b>appel a nouveau avec le nom d\' origine :</b> '; 
echo $CCK->uneMethode ('David' , 'DRAPEAU') .'<br />' ; 
?> 

Le resultat est affiche par le script ck_renommer_methode.php. 



aunel avec le nom d'origine : Bonjour David DRAPEAU 

methode renommee avec succes 

appel avec le nouveau nom : Bonjour David DRAPEAU 

appel a nouveau avec le nom d' origine : 

Fatal error: Call to undefined method UneClasse::uneMethode() in C:VPri 



Fig. 7.2 : 

Le script 

ck_renommer_methode. php 
execute dans le 
navigateur 



Lors de l'appel de la fonction avec le nom d'origine (uneMethodeQ) et avant de l'avoir 
renommee, la fonction existe bien et fait ce qu'elle doit faire. Une fois renommee 
laNouvel leMethode(), si Ton appelle la meme fonction par son nouveau nom, elle est 
toujours fonctionnelle. Par contre, si on l'appelle a nouveau avec son nom d'origine 
(uneMethode()), elle genere cette fois une erreur fatale, puisque pour PHP, elle n'existe 
plus sous son nom d'origine. 

Supprimez les deux lignes qui generent l'erreur fatale ainsi que la ligne de commentaire 
qui y est associee : 



// Puis on appelle a nouveau 


par 


le 


nom 


d' 


origine 


echo 


'<b>appel a nouveau avec 


le 


nom 


d\' 


origine 


:</b> ' ; 


echo 


$CCK->uneMethode ( ' David' 


, 'DRAPEAU' 


) 


'<br 


/>'; 



Placez maintenant un lien, apres la balise ?>, qui va pointer vers un fichier dans lequel 
vous allez appeler la methode avec son nouveau nom. Le lien est : 

<a href="methode_renommee.php">Methode renommee</a> 

Le script ck_methode_renommee.php montre les trois lignes de codes a utiliser. II serait 
tres difficile de faire plus simple : 
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Jfet ck_methode_renommee.php 

<?php 

require_once ( ' classe_UneClasse . php' ) ; 

// On instancie un objet de la classe 
$CCK = new UneClasse () ; 

// Puis on utilise la methode renommee precedemment 

// en utilisant son nouveau nom 

echo $CCK->laNouvelleMethode ('David' , ' DRAPEAU' ) .'<br/>'; 

?> 



Et void ce qui s'affiche dans le navigateur a l'execution du script. 

Fig. 7.3 

'igate 



1 Fig. 7.3 : 

Fatal error: Call to undefined method UneClasse::laNouvelleMemodeO in C:VPrl Exemple d'affichage 

^ I dans le naviqateur 



Alors, vous etes surpris 
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/!\ Code dynamique, ecriture dans fichier 



Ce n'est pas parce que vous avez modifie dynamiquement le code que la modification s'est inscrite en 
dur en modifiant le fichier PHP. Pour cela, vous devez utiliser les fonctions de lecture et d'ecriture dans 
les fichiers. 



Si vous ouvrez le fichier PHP, vous verrez que le code n'a change en rien. Et c'est pour 
cela que quand vous cliquez sur le lien pour executer le script ck_methode_renommee.php 
dans le navigateur en gardant le nouveau nom de la methode (laNouvel leMethodeQ), 
PHP genere une erreur fatale. Pour executer a nouveau la methode dans ce script, ainsi 
que dans tous les autres ou la fonction n'a pas ete renommee auparavant, vous devez 
utiliser le nom d'origine (uneMethode()) de la methode. 

Aj outer une methode 

Nous avons suffisamment insiste sur la difference entre le code dynamique et l'ecriture 
dans un fichier. Voici a present comment ajouter dynamiquement une fonction a la classe 
UneClasse{} : 



$^£ ck_ajouter_methode.php 



<?php 

require_once ( ' classe_UneClasse . php' ) 
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// On ecrit dans le heredoc les instructions 

// qui seront situees dans le corps de la fonction 

$code =<«codemethodeajoutee 

\$sum = \$numl + \$num2; 

return \$sum; 

codemethodeajoutee; 



// On ajoute une nouvelle methode dans la classe UneClasse 
// avec un acces public (CLASSKIT_ACC_PUBLIC) 
// la fonction contient deux arguments 
classkit_method_add (' UneClasse' , 'methodeAjoutee' , 
'$numl, $num2', $code, CLASSKIT_ACC_PUBLIC) ; 

// creation d'un objet Example 

$oUC = new UneClasse () ; 

echo $oUC->methodeAjoutee (12, 14); 

?> 

La fonction est bien ajoutee a la classe. Mais elle Test dynamiquement. Si vous editez a 
nouveau votre fichier PHP dans lequel est defmie la classe, celle-ci n'a en rien change. 
Quelles que soient les manipulations que vous effectuerez avec l'extension Classkit, rien 
ne sera modifie en dur (ecrit) dans le fichier. La fonction utilisee pour ajouter 
dynamiquement du code est : classki tjnethod_add(). 

bool cl asskit_method_add(chaTne $nom_classe, chaTne $nom_methode, 

chaTne $args, chaTne $code [, entier $drapeaux] ) 

Le premier parametre ($nom_classe) definit la classe dans laquelle la nouvelle methode 
va etre ajoutee. Le nom de la nouvelle methode est defini dans le deuxieme parametre 
($nom_methode). Le troisieme parametre ($args) definit la liste des variables qui seront 
integrees dans la nouvelle methode. Le quatrieme parametre ($code) represente le corps 
de la fonction dans lequel les instructions sont definies et le cinquieme parametre definit 
le type d' acces a la methode ajoutee. En ce qui concerne le cinquieme parametre, les 
valeurs pour le type d'acces sont definies par des constantes predefinies avec l'extension 
Classkit. Les constantes sont CLASSKIT_ACC_PRIVATE pour un acces prive, CLASSKIT 
_ACC_PROTECTED pour un acces protege et CLASSKIT_ACC_PUBLIC pour un acces public. 

Redefinir une methode 

Vous pouvez, avec Classkit, redefinir une methode, c'est-a-dire lui donner de 
nouvelles instructions et meme de nouveaux arguments. La fonction s'appelle 
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classkit_method_redefine() et elle effectue exactement la meme action que 
classkitjnethod_add() a la difference que cl asskit_method_add() cree une nouvelle 
fonction alors que classki t_method_redefine() recupere une fonction existante. 

bool cl asskitjnethod_redefine(chaTne $nom_classe, chaTne $nom_methode, 

chaTne $args, chaTne $code [, entier $drapeaux] ) 

Le role des arguments de la fonction classki t_method_redefine() est exactement le 
meme que pour ceux de la fonction classki t_method_add(). 

Supprimer une methode 

Avec Classkit, il est possible de supprimer une methode, que celle-ci soit definie 
dynamiquement par cl asskit_method_add() ou non. II suffit d'utiliser la fonction 
classki t_method_remove(). Cela peut s'averer necessaire pour securiser le code. Ainsi, 
vous pouvez supprimer dynamiquement une fonction dangereuse pour le script courant et 
pourtant indispensable pour d'autres scripts du projet. 

bool cl ass kitjnethod_remove (chaTne $nom_classe, chaTne $nom_methode) 

Le premier argument est le nom de la classe dans laquelle se trouve la methode qui est 
elle-meme definie en second parametre de la fonction. 

7.2 Passer la vitesse superieure avec Runkit 

Runkit est une extension PHP plus evoluee que Classkit. D'ailleurs, Runkit possede ses 
propres constantes predefinies ainsi que les constantes predefinies de Classkit. Runkit agit 
sur les classes en cours d'execution mais pas seulement. Elle agit egalement sur les 
fonctions. Vous allez decouvrir qu'avec Runkit, il est possible d'exploiter le code PHP de 
facon plus evoluee qu'avec Classkit. 

Pour commencer, vous allez decouvrir les directives de configuration de Runkit a placer 
dans le php.ini. Ensuite, nous aborderons en premier lieu les fonctions de Runkit 
similaires a celles etudiees dans la premiere partie avec Classkit. Enfin, l'etude portera sur 
les fonctions de Runkit qui permettent d'effectuer des manipulations dynamiques sur le 
code PHP et qui sont impossibles avec l'extension Classkit. 

De meme que pour Classkit, installer Runkit via XAMPP est tres simple. II suffit d'editer 
le php.ini et de decommenter la ligne ;extension=php_runkit.dl 1 en supprimant le 
point-virgule (;) qui se trouve en debut de ligne. 
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Directives de configuration 

Runkit possede deux directives de configuration (a placer dans le fichier php. ini) qui sont 
run kit. super-global qui a pour valeur par defaut une chaine de caracteres nulle et 
runkit. internal_override qui a la valeur numerique par defaut. 

runkit.superglobal permet de definir les variables qui vont etre reconnues par le moteur 
PHP lui-meme. En fait, elles ont la meme portee que des variables superglobales bien plus 
connues qui sont $_GET, $_P0ST, $_SERVER, etc. 

runkit.internal_override = 1 permet de surcharger des fonctions internes a PHP en 
plus des fonctions definies par l'utilisateur. Par defaut, runkit. internal_override = et 
permet uniquement la surcharge de fonctions ecrites par le programmeur et non les 
fonctions internes a PHP. 

Fonctions similaires a Classkit 

Renommer une methode 

La fonction qui renomme une methode (fonction situee dans une classe) s'appelle 
runkit_method_rename(). Son fonctionnement est identique a classkit_method 
_rename() et ses argument sont les memes et ont les memes roles. 

bool runkit_method_rename(chaTne $nom_classe, chaTne $nom_methode, chaTne 
$nouveau_nom) 

II ne faut pas confondre runki tjnethod_rename() qui agit sur une fonction definie dans 
une classe avec runki t_functi on_rename() qui agit sur une fonction definie hors de toute 
classe et qui sera etudiee un peu plus loin dans ce meme chapitre. Le script 
rk_renomm.er_methode.php montre un exemple tres simple de l'utilisation de 

runkit function renameQ : 



$W rk_renommer_methode.php 



<?php 

// On inclut le fichier dans lequel on a defini la classe 

// et la methode que l'on va renommer 

requireonce (' classe_UneClasse.php' ) ; 

// On instancie un objet de la classe 
$CCK = new UneClasseO ; 

// Avant de renommer, on appelle avec le nom d' origine 
echo '<b>appel avec le nom d\' origine :</b> ' ; 
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echo $CCK->uneMethode ('David' , ' DRAPEAU' ) . ' <br />' ; 

// On renomme la methode uneMethode ( ) 

// qui va s'appeler maintenant laNouvelleMethode ( ) 

$renommer = runkit method rename (' Uneclasse' , 

' uneMethode' , ' laNouvelleMethode' ) ; 
if ($renommer) { 

echo ' <bxf ont color="blue"> 

methode renommee avec succes 
</f ontx/b><br/>' ; 
} else { 

echo ' <bxf ont color="red"> 

impossible de renommer la methode 
</f ontx/bxbr/>' ; 
} 

// Puis on utilise la methode renommee precedemment 

// en utilisant son nouveau nom 

echo '<b>appel avec le nouveau nom : </b>' ; 

echo $CCK->laNouvelleMethode ('David' , 'DRAPEAU') .'<br/>'; 

// Puis on appelle a nouveau par le nom d' origine 
echo '<b>appel a nouveau avec le nom d\' origine :</b> ' ; 
echo $CCK->uneMethode ('David' , 'DRAPEAU') .'<br />' ; 
?> 

Aj outer une methode 

La fonction qui ajoute une methode (fonction situee dans une classe) s' appelle 
runkit_method_add(). Son fonctionnement est identique a classkit_method_add() et ses 
argument sont les memes et ont les memes roles. 

bool runkitjnethod_add(chaTne $nom_classe, chaTne $nom_methode, chaTne 
$args, chaTne $code [, entier $drapeaux]) 

II ne faut pas confondre runkit_method_add() qui agit sur une fonction defmie dans une 
classe avec runki t_function_add() qui agit sur une fonction defmie hors de toute classe 
et qui sera etudiee ulterieurement dans ce meme chapitre. Le script rk_ajouter_methode 
.php montre un exemple tres simple de l'utilisation de runki t_add_method() : 



<^£ rk_ajouter_methode.php 



<?php 

requireonce ( ' classe_UneClasse . php' ) ; 

// On ecrit dans le heredoc les instructions 



233 



Dynamiser PHP5 avec Classkit 



// qui seront situees dans le corps de la fonction 
$code =<«codemethodeajoutee 
\$sum = \$numl + \$num2; 
return \$sum; 
codemethodea j outee ; 

// On ajoute une nouvelle methode dans la classe UneClasse 
// avec un acces public (CLASSKIT_ACC_PUBLIC) 
// la fonction contient deux arguments 
runkit_method_add (' UneClasse' , 'methode_aj outee' , 
'$numl, $num2', $code, CLASSKIT_ACC_PUBLIC) ; 

// creation d'un objet Example 

$oCCK = new UneClasse () ; 

echo $oCCK->methode_aj outee (12, 14); 

?> 



/I\ Majuscule vs minuscule 

Si vous analysez le script ck_ajouter_methode.php, vous vous rendrez compte que le nom de la fonction 
ajoutee est methodeAjoutee(). Ce nom de methode avec Runkit generera un message d'erreur, lors de 
son appel, comme quoi PHP ne trouve pas la fonction demandee et dira que celle-ci n'existe pas. En 
effet, Runkit n'accepte que les noms de fonctions avec lettres minuscules et underscore (J. C'est pour 
cette raison que dans le script rk_ajouter_methode.php, le nom de la fonction a ajouter est 
methode_ajoutee() au lieu de methodeAjoutee(). 

Ce bug n'existe pas avec la fonction runkit_method_rename{) puisqu'il a ete possible de renommer la 
fonction uneMethode() par le nom laNouvelleMethode() dans le script rk_renommer_methode.php. 



Redefinir une methode 

Q) Chapitre 1 

Voici, comme promis, le bon login et le bon motde passe [password) du cas pratique du chapitre 1 au 
sujet de la compression : 

$bonlogin = shal ( ' yeahhh' ) ; 
$bonpassword = shal (' tropf ort' ) ; 



La fonction de l'extension Runkit qui redefmit une methode situee dans une classe 
s'appelle runki t_method_redefine(). Son fonctionnement est identique a la fonction de 
l'extension Classkit classki tjnethod_redefine() et ses argument sont les memes et ont 
les memes roles. 
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bool runki t_method_redefine(chaTne $nom_classe, chaTne $nom_methode, 

chaTne $args, chaTne $code [, entier $drapeaux]) 

II ne faut pas confondre runki t_method_redef i ne() qui agit sur une fonction definie dans 
une classe avec runki t_function_redefine() qui agit sur une fonction definie hors de 
toute classe et qui sera etudiee ulterieurement dans ce meme chapitre. Le script 
rk_modifier_methode.php montre un exemple concret de ce que fait la fonction 
runkit_method_redefine() : 

J^jt rk_modifier_methode.php 

<?php 

require_once ( ' classe_UneClasse . php' ) ; 

// On ecrit dans le heredoc les instructions 

// qui seront situees dans le corps de la fonction 

$code =<«codemethodeaj outee 

\$sum = \$numl + \$num2; 

return \$sum; 

codemethodea j outee ; 

// On ajoute une nouvelle methode dans la classe UneClasse 
// avec un acces public (RUNKIT_ACC_PUBLIC) 
// la fonction contient deux arguments 
runki t_method add ( 'UneClasse' , 'une somme' , 

'$numl, $num2', $code, RUNKI T_ACC_PUBLIC ) ; 

// instanciation de la classe UneClasse 

$oUC = new UneClasse () ; 

echo 'La somme est : ' . $oUC->une somme (12, 14) ; 

// On redefinit la fonction une somme 
// qui va s'appeler un_produit 
// et qui va calculer le produit 
// des deux nombres $numl, $num2 . 

// On renomme la methode une somme 

// qui va s'appeler maintenant un produit 

$renommer = runkit method rename (' Uneclasse' , 

'une somme', ' un produit'); 
if ($renommer) { 

echo '<br/xbxfont color="blue"> 
methode renommee avec succes 
</f ontx/b><br/>' ; 
} else { 

echo '<br/xbxfont color="red"> 

impossible de renommer la methode 
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</fontx/bxbr/>' 



} 



// On ecrit dans le heredoc les instructions 

// qui seront situees dans le corps de la fonction 

$code =<«codemethodeajoutee 

\$sum = \$numl * \$num2; 

return \$sum; 

codemethodea j outee ; 

// Puis on redefinit la methode 

$redefinir = runkit method redefine (' UneClasse' , 
' un produit' , '$numl, $num2', 
$code, RUNKIT_ACC_PUBLIC) ; 

if ( $redef inir ) { 

echo '<br/Xb><font color="blue"> 

methode redefinie avec succes 
</f ontx/bxbr/>' ; 
} else { 

echo '<br/xbxfont color="red"> 

impossible de redefinir la methode 
</f ontx/bxbr/>' ; 
} 

// On affiche le resultat du produit 

echo ' Le produit est : '. $oUC->un_produit (12, 14); 

?> 



(J) CLASSKIT_ACC_* vs RUNKIT_ACC_* 



Pour definir le type d'acces a la methode, avec Classkit, il y a CI_ASSKIT_ACC_PRIVATE, 
CLASSKIT_ACC_PROTECTED et CLASSKIT_ACC_PUBLIC. Avec Runkit, il y a RUNKIT_ACC_PRIVATE, 
RUNKIT_ACC_PROTECTED et RUNKIT_ACC_PUBLIC. 

Runkit a egalement la possibilite d'accepter les constantes CLASSKIT_ACC_* a la place des constantes 
RUNKIT_ACC_*, ce qui peut faire gagner enormement de temps le jour ou, par exemple, vous recuperez 
un projet qui contient beaucoup de code dynamique ecrit avec Classkit et que vous comptez I'ameliorer 
en utilisant Runkit. 



Supprimer une methode 

La fonction qui supprime dynamiquement une methode (fonction situee dans une classe) 
s'appelle runkit_method_remove(). Son fonctionnement est identique a 
classkitjnethod_remove() et ses argument sont les memes et ont les memes roles. 
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bool runki t_method_remove(chaTne $nom_classe, chaTne $nom_methode) 

II ne faut pas confondre runki t_method_remove() qui agit sur une fonction definie dans 
une classe avec runkit_function_remove() qui agit sur une fonction definie hors de toute 
classe et qui sera etudiee ulterieurement dans ce meme chapitre. 



flW rk_supprimer_methode.php 



<?php 

class UneClasse { 

public function methodeMortelle ( ) { 
return ' Je veux vivre ! ! ! ' ; 

} 
} 

$oUC = new UneClasse () ; 

echo ' avant suppression dynamique de la methode : '; 

echo $oUC->methodeMortelle () ; 

echo '<br/xbr/>' ; 

runki t_method remove (' UneClasse' , 'methodeMortelle') 
echo ' apres suppression dynamique de la methode : '; 
echo $oUC->methodeMortelle () ; 

?> 



Depasser les possibilites de Classkit 

Avec Classkit et Runkit, vous avez jusqu'a present compris comment faire pour 
manipuler des fonctions definies dans des classes. PHP permet egalement de definir des 
fonctions directement dans des scripts sans pour autant les placer dans une classe. 
Reprenez les quatre fonctions precedentes et remplacez dans le nom de la fonction le mot 
method par le mot function et vous aurez memorise en deux secondes les noms des 
nouvelles fonctions que vous allez voir dans cette seconde partie. Vous l'avez compris, les 
quatre fonctions de Runkit qui vont suivre sont : runkit_function_add(), 
runkit_function_redefine(), runki t_function_rename() et, pour terminer cette partie, 
runkit_function_remove(). Supprimez ensuite le premier parametre (le nom de la 
classe) et le dernier (le type d'acces en ce qui concerne la fonction d'ajout et de 
redefinition) et vous aurez memorise, encore en deux secondes, la syntaxe de chacune de 
ces nouvelles fonctions. 
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Aj outer une fonction 

La fonction runki t_function_add() permet d'ajouter une nouvelle fonction dans le script 
courant. 

bool runki t_function_add(chaTne $nom_fonction, 

chaTne $liste_arguments, chaTne $code) 

II s'agit bien de fonction et non de methode. Autrement dit, celle-ci (la fonction) ne sera 
pas definie dans une classe. Le script rk_php_statique.php (premier exemple) montre 
l'utilisation d'une fonction telle que cela se fait en dur dans le script tandis que le script 
rk_php_dynamique.php (second exemple) montre l'utilisation de la meme fonction 
generee dynamiquement. 

Premier exemple 

^ rk_php_statique.php 

<?php 

function somme($a, $b) { 

return $a + $b; 
} 

echo somme(3, 7 ) ; 
?> 



Second exemple 



^j rk_php_dynamique.php 








<?php 








runkit function add ( ' somme' , 


'$a, 


$b' , 


'return $a + $b; ' ) ; 


echo somme (12, 14); 








?> 









Modifier une fonction 

La fonction runki t_functi on_redef i ne() permet de redefinir une fonction situee dans le 
script courant. 

bool runkit_function_redefine(chaine $nom_fonction, 

chaTne $liste arguments, chaTne $code) 
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Renommer une fonction 

La fonction runkit_function_rename() permet de renommer une fonction situee dans le 
script courant. 

bool runki t_function_rename(chaTne $nom_fonction, chaTne $nouveau_nom) 

Supprimer une fonction 

La fonction runkit_function_remove() permet de supprimer une fonction situee dans le 
script courant. 

bool runki t_function_remove(chaTne $nom_fonction) 

Jouer avec les constantes 

Tout comme pour les fonctions et les methodes, Runkit gere aussi les constantes. Vous 
pouvez creer une constante, la modifier et/ou la supprimer. 

bool runki t_constant_add (chaTne $nom_constante, mixte $valeur) 

bool runkit_constant_redefine(cha!ne $nom_constante, mixte $nouvelle_valeur) 

bool runki t_constant_remove(string $nom_constante) 

La difference entre runki t_constant_add() et runki t_constant_redefine() est que la 
premiere cree une constante qui n'existe pas avant l'appel de la fonction et que la seconde 
fonction recupere une constante existante arm de lui affecter une nouvelle valeur. 

Le script rk_constantes.php montre un exemple des fonctions runki t_constant_add(), 
runki t_constant_redefine() et runki t_constant_remove(). 

<^jt rk_constantes 

<?php 

runkit_constant_add('NOMBRE' , 3) ; 

echo 'La constante creee a pour valeur '. NOMBRE; 

// affiche: la constante creee a pour valeur 3 

runkit_constant_redef ine ( ' NOMBRE' , 12 ) ; 
echo '<br/>La constante a ete redefinie 

avec la valeur ' . NOMBRE; 
// affiche: la constante a ete redefinie avec la valeur 12 

runkit_constant_remove ('NOMBRE' ) ; 

echo '<br/>La constante a ete supprimee . ' ; 
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echo ' Elle a pour valeur ' . NOMBRE; 

// affiche: La constante a ete supprimee. 

// Elle a pour valeur NOMBRE 

?> 

Le premier echo affiche bien la valeur de la constante definie avec 
runkit_constant_add() ainsi que le deuxieme echo qui affiche tout autant la nouvelle 
valeur de la constante redefinie avec runkit_function_redefine(). Cependant, le 
troisieme echo affiche NOMBRE parce que la constante NOMBRE a ete supprimee grace a la 
fonction runkit_constant_remove() et echo considere done NOMBRE comme une chaine, 
bien que celle-ci ne soit pas placee entre guillemets, et non comme une constante. 

Agir sur les classes 

Deux fonctions permettent d'agir sur les classes et comme toujours, leur nom est tres 
explicite. La premiere permet de creer un heritage et se nomme runki t_cl ass_adopt () et 
la seconde fait Taction inverse et s'appelle runkit_class_emancipate(). Voici un 
exemple hors informatique. Vous etes une personne adulte avec une certaine situation 
stable et vous desirez adopter un enfant ; celui-ci heritera de vous alors qu'a l'inverse 
vous etes un pere (ou une mere) et vous ne supportez plus votre enfant et vous ne voulez 
pas qu'il herite de vos richesses : alors vous l'emancipez. C'est exactement la meme 
chose avec les deux fonctions citees precedemment. Le script rk_adopter_emanciper.php 
montre un exemple tres simple et tres concret de 1' adoption et de 1' emancipation 
dynamique des classes : 

bool runki t_cl ass_adopt(chaTne $nom_classe_enfant, 

chaTne $nom_classe_parent) 

bool runkit class emancipate(chaTne $nom classe parent) 



** rk_adc.pter_emanciper.php 



<?php 

class ClasseAdulte { 

..public function messagelmportant ( ) { 

. . . .return "J'ai adopte un enfant"; 

..} 

} 

class ClasseEnfant { 
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} 

$oEnfant = new ClasseEnf ant () ; 
//echo $oEnf ant->messageImportant ( ) ; 

runkit_class_adopt ('ClasseEnf ant', ' ClasseAdulte' ) 
echo $oEnf ant->message!mportant ( ) ; 



runkit class emancipate (' ClasseParent' 
echo $oEnf ant->messageImportant ( ) ; 
?> 



A la ligne 13, il y a une instruction mise en commentaire. Cette ligne appelle la fonction 
messageImportant() de la classe ClasseAdulte avant que celle-ci ait adopte la classe 
ClasseEnf ant : cela genere une erreur fatale et stoppe le script adopter _emanciper.php 
aussitot apres cette instruction lorsque cette ligne est decommentee. 

7.3 Conclusion 

Vous voici maintenant arme pour utiliser correctement Runkit afin de generer du code 
dynamique et faire evoluer considerablement vos connaissances et votre facon de 
programmer. La seule limite au codage dynamique en PHP est votre imagination. Le code 
PHP, qui n'a plus rien a envier a Java ou a C++ en termes de possibilites, est devenu 
tellement puissant que les limites seront celles que vous vous imposerez (consciemment 
ou inconsciemment). 

7.4 Check-list 

Avec Classkit, nous avons appris a : 

</ aj outer des methodes de maniere dynamique ; 
</ les renommer ; 
>/ les redefinir ; 
«/ les supprimer. 

Avec Runkit, nous avons appris a : 

*/ effectuer le meme travail qu'avec Classkit ; 

>/ manipuler les fonctions ; 

^ creer/detruire des heritages de classes. 
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Dynamiser 
e code avec 
Reflection 

Cet article fait exception a la regie du livre, car il ne 
s'agit pas Id d'une extension mais d'une 
API [Application Programming Interface) faisant partie de 
la version objet de PHP5. Cette API a pour nom de 
bapteme Reflection, aussi appelee introspection. Utilisee 
correctement, elle peut vous permettre de vous documenter 
sur une librairie PHP, sur des fonctions et des extensions 
internes ou externes a PHP. 
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8. 1 Les classes de Reflection 

L'API de reflexion est principalement utilisee pour la POO (Programmation orientee 
objet). Les classes sont les suivantes : 

class Reflecti on {} 
interface Reflectory} 

class ReflectionException extends Exception{} 

class ReflectionFunction implements Reflector{} 

class ReflectionParameter implements Reflector{} 

class ReflectionMethod extends ReflectionFunction{} 

class ReflectionClass implements Reflector{} 

class ReflectionObject extends ReflectionClassU 

class ReflectionProperty implements Reflector{} 

class ReflectionExtension implements Reflector{} 

8.2 Reflection et ReflectionClass : dissequer une classe en 
une ligne de code 

Comme nous venons de l'ecrire, utiliser la reflexion est un excellent moyen pour etudier 
une classe PHP dans sa totalite. Reflection et ReflectionCl ass permettent de dissequer 
une classe et de savoir tres precisement comment elle est constituee. La fonction qui 
recupere toutes les donnees de la classe et les affiche dans le navigateur se nomme 
export(). 

Reflection: :export(mixte $nom_classe, bool $retour) 

En cas de succes, export () retourne une chaine, ou plutot un tableau, que vous pouvez 
tres facilement formater en utilisant les balises <prex/pre>. On pourrait considerer que 
export () pour la classe Reflection{} est l'equivalent de print_r() pour les tableaux. 

<^ methode_export.php 

<?php 

// Choisir une classe 

$classname = 'Reflection'; 

echo ' <pre>' ; 

// Voici LA ligne qui affiche 

// toutes les informations de la classe 
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Reflection: :export (new ReflectionClass ($classname) ) ; 

echo ' </pre>' ; 

?> 

Le resultat de l'execution dans un navigateur de methode_export.php est visible sur la 
figure suivante : 



T ^^ III |" http://localhost/dynamisez_php/chap[ 



Class [ class Reflection ] { 



Constants [0] { 



Static properties [0] { 






Static methods [2] { 

Method [ static public method getHodif ierNames ] { 



Parameters [1] { 

Parameter #0 [ ^modifiers ] 



Method [ static public method export ] { 

- Parameters [2] { 

Parameter #0 [ Reflector ^reflector ] 
Parameter #1 [ ^return ] 



Properties [0] { 



Methods [0] { 



► Fig. 8.1 : 

La classe Reflection 
dissequee 



Voici quelques explications sur le resultat affiche dans le navigateur. La premiere ligne 
CI ass [classe Reflection] indique le nom de la classe. La ligne Constants [0] indique 
que la classe Reflection ne contient aucune constante dans son corps. C'est la meme 
chose pour les proprietes statiques : Static properties [0]. En ce qui concerne les 
methodes statiques, la classe Reflection en possede deux qui ont toutes deux un acces 
public (public). La quantite de parametres d'une fonction est signalee par la ligne 
Parameters [0] . Et la description du premier argument est signalee par la ligne Parameter 
#0 [...] . La suite est tout aussi simple a comprendre. 

Si la classe n'existe pas, un message d'erreur fatale est affiche dans le navigateur et le 
script est stoppe immediatement apres la generation de l'erreur. Le script 
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err_appel_xdebug.php montre un exemple avec Xdebug appelee par Reflection et qui 
genere un message d'erreur puisque Xdebug est le nom d'une extension mais ce n'est pas 
le nom d'une classe reconnue par PHP. 

Qq err_appel_xdebug.php 

<?php 

echo ' <pre>' ; 

Reflection : : export (new Ref lectionClass ( ' xdebug' ) ) ; 

echo ' </pre>' ; 

?> 

Ce qui a pour resultat l'affichage dans le navigateur du message suivant : 



Fatal eiicu: Uncaught exception 'ReflectionException' with message 'Class xdebug does 
not exist' in C:\xampp\htdocs\dynamisez_php\chap08\php_manual\listingl.php: 2 Stack 
trace: #0 C:\xampp\htdocs\dynamisez_php\chap08\prip_manual\listingl .php (2): 

ReflectionClass-> construct('xdebug') #1 {main} thrown in 

C:b^ampp\htdacs\^ F namisez_php\chapOS\php_raainial\listiiigl.php online 2 



Fig. 8.2 : Erreur : Xdebug n'est pas programmee en POO. 



Vous voulez tester pour une autre classe ? Reprenez le script methode_export.php et 
modifiez la valeur de la variable $classname = 'Reflection 1 ; par $classname 
= 'ReflectionClass 1 ; et vous connaitrez toutes les fonctions de la classe 
ReflectionClassU que vous avez a votre disposition. Observez le script reflexion 
_sur_ReflectionClass.php : 

&& ref lexion_sur_Ref lectionClass. php 

<?php 

// Choisir une classe 

$classname = 'ReflectionClass'; 

echo ' <pre>' ; 

// Voici LA ligne qui affiche 

// toutes les informations de la classe 

Reflection : : export (new ReflectionClass ($classname) ) ; 

echo ' </pre>' ; 

?> 
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Class [ class ReflectionClass implements Reflector ] { 

- Constants [3] { 

Constant [ integer IS_IMPLICIT_ABSTRACT ] { 16 } 

Constant [ integer IS_EXPLICIT_ ABSTRACT ] { 32 } 

Constant [ integer IS FINAL ] { 64 } 



Static properties [0] { 



Static methods [1] { 

Method [ static public method export ] { 

- Parameters [2] { 

Parameter #0 [ ^argument ] 
Parameter #1 [ ^return ] 



Properties [1] { 

Property [ public $name ] 



Methods [40] { 

Method [ final private method clone ] { 



Method [ public method construct ] { 



Parameters [1] { 

Parameter #0 [ ^argument ] 



Method [ public method toString ] { 



Method [ public method getName ] { 



Method [ public method islnternal ] { 



Fig. 8.3 : 

Un extra it de 
ReflectionClass par 
reflexion 



L 



Tlpr.hnd T rmTn 1 i r Tnpr.hnd i =! 



TT^prDpflnp i l 1 



Quand vous executez le script dans votre navigateur, vous avez une description tres 
precise de ce que vous pouvez utiliser comme fonctions et comme attributs. Vous savez 
deja que la classe ReflectionClass{} possede trois constantes de type entier (int), une 
methode statique nommee export () (celle que vous avez utilisee dans le script precedent) 
et quarante methodes dont seules celles qui ont un acces public (publ i c) sont utilisables. 
Les methodes d'acces protege (protected) ne sont utilisables que pour les classes qui 
sont des classes etendues de la classe ReflectionClass{} et les methodes, comme la 

methode clone(), qui ont un acces prive (private) ne sont accessibles que par les 

methodes incluses dans la meme classe. Quant aux methodes construct () et 
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toString(), elles sont egalement appelees, en PHP, des methodes magiques et sont 

utilisees implicitement. Autrement dit, vous n'avez pas a vous en occuper. 

8.3 Tout connattre d'une fonction 

Une fois la reflexion faite sur la classe, vous pouvez pousser l'experience encore plus 
avant en effectuant la reflexion sur chaque fonction de la classe. La classe qui s'en charge 
est ReflectionFunction{}. Et si vous effectuez une reflexion sur cette classe (script 
reflexion_sur_ReflectionFunction.php), un extrait du resultat est visible a la figure 
suivante : 



^* reflexion_sur_Ref lection Function, php 



<?php 

echo ' <pre>' ; 

Reflection: :export (new Ref lectionClass (' Ref lectionFunction' ) ) ; 

echo ' </pre>' ; 

?> 



Class [ class Ref lectionFunction extends Ref lectionFunctionAristract implements Reflector ] { 

- Constants [1] { 
Constant [ integer IS_DEPRECATED ] { 2 62144 } 

i 

- Static properties [0] { 
i 

- Static methods [1] { 
Method [ static public method export ] { 

- Parameters [2] { 

Parameter #0 [ Sname ] 
„ , li ^_ L c ^^^ 



Fig. 8.4 : Un extrait de Reflection Function par reflexion 

La premiere ligne indique que la classe ReflectionFunction{} est une classe etendue de 
la classe ReflectionFunctionAbstract{} et qu'elle implemente aussi l'interface 
Reflector{}. Vous pouvez aussi voir dans les methodes statiques que la fonction 
export () s'y trouve a nouveau. Le script fonction_calculerSomme.php utilise la methode 
export() de la classe ReflectionFunction{} qui retourne sous forme de chaine tous les 
renseignements de la fonction cal culerSomme() : 

*^ fonction_calculerSomme.php 

<?php 
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// On definit une fonction toute simple 

/** 

* Ici la description de la fonction qui sera 

* recuperable par getDocComment ( ) de la classe 

* Ref lectionFunction 
* 

* @param int $argl 

* Sparam int $arg2 

* @return unknown 
*/ 

function calculerSomme (int $argl, int $arg2){ 

return $argl + $arg2; 
} 

echo ' <pre>' ; 

// LA ligne qui disseque la fonction 

echo Ref lectionFunction : : export (calculerSomme) ; 

echo ' </pre>' ; 

?> 

Le resultat est visible sur la figure suivante. 



/** 

* Ici la description de la fonction qui sera 

* recuperable par getDocComment ( ) de la classe 

* Ref lectionFunction 

* Sparam int Sargl 

* Sparam int $arg2 

* @ return unknown 
*/ 

Function [ function calculerSomme ] { 

@@ C:\Program Files\ xampp\ htdocs\ dynamise z_php\ chap08\ dissequer_f onction. php 13 

- Parameters [2] { 

Parameter #0 [ int Sargl ] 

Parameter #1 [ int Sarg2 ] 
} 



Fig. 8.5 : Reflexion de la fonction calculerSomme 

Comme d' habitude, la premiere ligne donne le nom de la fonction. La deuxieme ligne 
donne le chemin complet et le nom du fichier dans lequel est definie la fonction. La 
deuxieme ligne donne egalement d'autres informations : le numero de ligne ou commence 
la fonction et le numero de ligne ou elle finit. Dans cet exemple, il est indique 13 - 15. 
Si vous analysez le script fonction_calculerSomme.php, il est aise de se rendre compte 
que la definition de la fonction commence a la treizieme ligne et se termine a la 
quinzieme ligne. 



249 



Dynamiser le code avec Reflection 



Voici les fonctions de la classe ReflectionFunction{} : 

chaTne getName() retourne le nom de la fonction. 

bool islnternal () retourne true si une fonction est interne a PHP ou false si elle 

l'a ete par le programmeur. 

bool isUserDefined() effectue l'inverse de islnternal () et retourne true si une 

fonction a ete definie par le programmeur ou f al se si elle est interne a PHP 

chaTne getFileName() retourne le nom du fichier dans lequel se trouve la definition 

de la fonction. Si la fonction est interne a PHP, elle n'est done pas definie dans un 

fichier, getFileName() retourne une chaine vide. 

entier getStartLine() retourne le numero de ligne du debut de la definition de la 

fonction. 

entier getEndLineQ retourne la numero de ligne de la fin de la definition de la 

fonction. 

chaTne getDocComment() retourne le commentaire associe a la fonction a condition 

que celui-ci (le commentaire) soit formate de la facon suivante : 




nom_predefini peut avoir pour valeur : author, copyright, name, param, etc. 

tableau getStaticVariables() retourne sous forme de tableau les variables 
statiques definies dans la fonction. 

entier getNumberOfParameters() retourne le nombre de parametres de la fonction 
(les variables situees entre les parentheses de la fonction placee en reflexion), 
entier getNumberOfRequiredParameters() retourne le nombre de parametres 
obligatoires lors de l'appel de la fonction. Si une fonction comporte trois parametres 
dont un optionnel alors getNumberOf Parameters () retournera la valeur 3 et 
getNumberOfRequiredParameters() retournera la valeur 2. 

Le script dissequer_function.php montre un exemple d'utilisation de chacune des 
fonctions que nous venons de decrire : 

^W dissequer_fonction.php 

<?php 

// Utilisation des methodes de la classe Ref lectionFunction 

$F = new Ref lectionFunction (' printf ) ; 
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echo $F->isInternal ( ) 
? 'printf est une fonction interne a PHP' 
: 'printf est une fonction creee par un programmeur'; 

echo ' <br/>' ; 

/* * 

* Ceci est une fonction qui n'est pas interne a PHP 

* dauthor David DRAPEAU 

* 

* dparam int a 

* @param int b 

* @return int sum 

*/ 

function calculerSomme ($a, $b, $msg = 'la somme est ') { 

$c = $a + $b; 

return $msg . $c; 
} 

$nomFonction = 'calculerSomme'; 

$F = new Ref lectionFunction ($nomFonction) ; 

echo $F->isInternal ( ) 
? ' testFonction est une fonction interne a PHP' 
: 'testFonction a ete creee par un programmeur'; 

echo ' <br/>' ; 

// Restons toujours sur la fonction printf 

// 

// nom de la fonction 

$nom = $F->getName ( ) ; 

echo ' le nom de la fonction : '. $nom .'<br/>'; 

// nom du fichier dans lequel se trouve 
// la definition de la fonction 
$filename = $F->getFileName ( ) ; 

echo ' le nom du fichier ou est ecrite la fonction : ' . 
$filename .'<br/>'; 

// ligne de debut 

$ligneDeb = $F->getStartLine ( ) ; 

echo ' a quel endroit du fichier demarre 

la fonction : ligne ' . $ligneDeb .'<br/>'; 

// ligne de fin 



251 



Dynamiser le code avec Reflection 



$ligneFin = $F->getEndLine ( ) ; 

echo 'a quel endroit du fichier se termine 

la fonction : ligne ' . $ligneFin . '<br/>'; 

// les lignes de commentaires qui documentent la fonction 

$comment = $F->getDocComment ( ) ; 

echo 'commentaires sur la fonction :<br/>' ; 

echo ' <pre>' ; 

echo $comment; 

echo ' </pre>' ; 

// valeurs de retour 

$returns = $F->returnsRef erence ( ) ; 

echo $returns . '<br/>'; 

// parametres 

$param = $F->getParameters ( ) ; 

echo $param . '<br/>'; 

// nombre de parametres 

$nbParams = $F->getNumberOf Parameters () ; 

echo $nbParams . '<br/>'; 

// nombre de parametres requis 

$nbRqParams = $F->getNumberOf RequiredParameters ( ) ; 

echo $nbRqParams . '<br/>'; 

echo 'utilisation de export () <br/>' ; 

echo ' <pre>' ; 

Ref lectionFunction : : export ( ' calculerSomme' ) ; 

echo ' </pre>' ; 

?> 



8.4 ReflectionMethod : on entre dans la classe 

La difference entre la classe ReflectionFunction{ } et la classe ReflectionMethod{ } est 
que la premiere concerne les fonctions ecrites hors de toutes classes alors que la seconde 
concerne les methodes defmies a l'interieur d'une classe. II semble done logique que les 
informations qu'il est possible d'y recuperer soient differentes. Par exemple, s'agissant 
d'une methode, vous pouvez recuperer le nom de la classe dans laquelle elle est defmie. 
C'est une information qu'il est impossible de connaitre d'une fonction puisque celle-ci 
n'appartient a aucune classe. Une autre evidence est qu'une methode est aussi une 
fonction dans le sens ou, tout comme une fonction, la methode possede un nom, est 
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definie par l'utilisateur ou est interne a PHP, etc. La classe Refl ectionMethod{ } possede 
done des methodes heritees de la classe ReflectionFunction{} qui sont les suivantes : 
getName(), islnternal (), isUserDefined(), getFileName(), getStartLine(), 
getEndLine(), getDocComment(), getStaticVariables(), returnsReference(), 
getParameters(), getNumberOfParameters(), getNumberOfRequiredParameters(). 

Parmi les nouvelles methodes, vous avez les suivantes : 

public construct (mi xte $nom_classe, chaTne $nom_methode) qui est 

automatiquement utilisee lors de l'instanciation de l'objet de la classe. 

public chaTne toString() et egalement une methode magique (comme 

construct ()) dont vous n'avez pas a vous preoccuper. Elle jouera son role le 

moment venu. 

public static chaTne export (mi xte $nom_classe, chaTne $nom_methode, bool 

$retour). 

public mixte invoke(stdclass $object, mixte $args). 

public mixte invokeArgs(stdclass $objet, tableau $args). 

public bool isFinal () permet de verifier si une classe peut etre derivee ou non. 

publ ic bool isAbstract() verifie si une classe peut etre utilisee directement ou s'il 

faut passer par une autre classe qui en derive. 

public bool isPublic() determine si une methode possede un acces public. 

public bool isPrivate() determine si une methode possede un acces prive. 

public bool isProtected() determine si une methode possede un acces protege. 

publ ic bool isStatic() determine si une fonction peut etre redefinie (ou non) dans 

une classe qui en herite. 

public bool isConstructor() retourne true si la methode est un constructeur et 

false sinon. 

publ i c bool i sDestructor () retourne true si la methode est un destructeur et f al se 

sinon. 

public entier getModifiersQ. 

public Refl ectionCl ass getDeclaringClass() cree une reflexion sur la classe dans 

laquelle la methode (sur laquelle vous faites la reflexion) est definie. 

8.5 Cas pratique : un systeme de plug-ins 

Vous venez d' avoir une idee geniale (et rentable) et vous desirez creer une application 
complete en PHP5. Vous avez pour objectif de faire evoluer le projet en ajoutant, dans un 
futur plus ou moins proche, de nouvelles fonctionnalites et ce, sans avoir a retourner dans 
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le code deja ecrit. Et quand cette fonctionnalite est en place, un lien sur la page d'accueil, 
sur laquelle vous n'avez rien modifie, affiche le lien comme par magie. Car, une chose est 
sure, quand vous n'avez pas touche au code d'un projet durant des mois, se replonger 
dedans, meme quand vous en etes le concepteur, n'est pas toujours aise quand le projet 
fait plusieurs dizaines (centaines ?) de milliers de lignes de codes et quelques centaines 
(milliers ?) de fichiers. Vous allez decouvrir dans ce cas pratique, grace a la reflexion, que 
vous pourrez ajouter de nouvelles fonctionnalites sans avoir a retoucher le code deja ecrit 
dans le projet. Et l'avantage, c'est que l'inverse est tout aussi vrai. Vous pourrez 
supprimer une fonctionnalite juste en supprimant les fichiers concernes sans avoir a 
modifier quoi que ce soit dans le reste du projet. Et mieux encore, si vous desirez garder 
les fichiers presents sur votre serveur, vous n'aurez qu'a placer le code du plug-in et de 
la fonctionnalite en commentaire. 

Dans les differentes methodes etudiees, il y en aura trois. L'exemple est montre pour une 
application web quelle qu'elle soit : site Internet, application intranet/extranet. II s'agit de 
partir d'un noyau en MVC (Model View Controller) qui sera le coeur du projet. Plus 
significativement, il s'agit de la partie du programme qui prendra en compte toutes les 
nouvelles fonctionnalites sans que rien ne soit modifie dans ce projet. II existe done en 
racine un fichier index.php qui appelle le controleur. Egalement en racine, il y a un 
repertoire models qui contient tous les fichiers nommes Model*. php et un repertoire views 
qui contient tous les fichiers nommes View*. php ou * represente le nom de Taction a 
effectuer (par exemple, si vous desirez ajouter un client, les fichiers a creer seront 
ModelAjouterClient.php et ViewAjouterClient.php). Evidemment, il est egalement 
necessaire de creer un repertoire include qui contient des classes dont les fichiers sont 
nommes Class*. php. Puis, vient le repertoire le plus important, toujours en racine, qui est 
le fameux (indispensable !) repertoire nomme plug-ins dans lequel vous allez placer des 
modules, vos fameux plug-ins qui seront nommes *.php, qui ne sont ni des modeles, ni 
des vues mais des fonctionnalites automatiquement recuperees par le projet et rendront 
ainsi actifs les modeles et les vues des que le fichier .php sera ajoute dans le repertoire 
plug-ins (en gardant le meme exemple, pour que la fonctionnalite ajouter un cl ient soit 
prise en compte, vous ajouterez le fichier AjouterClient.php). En clair, toute la partie 
MVC est le noyau qui va recuperer les plug-ins arm de permettre a 1' application de 
recuperer les fonctionnalites au fur et a mesure que celles-ci sont installees. 

Premiere methode : la plus simple pour comprendre 

Dans le projet, vous decidez de consacrer une petite partie de la page d'accueil a 
l'affichage de liens vers des sites Internet distants, ce qui pourrait etre par exemple vos 
sites favoris, ceux que vous frequentez le plus. Probablement qu'au commencement du 
projet, il n'y aura aucun lien. Ce n'est pas la priorite du site. Done, il ne faut pas de 
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messages d'erreurs si le repertoire plug-ins ne contient aucun fichier et en meme temps 
il faut prevoir le fait qu'il en possedera bientot arm de ne pas avoir a revenir dans le code 
du noyau ulterieurement excepte pour optimiser celui-ci. 

%fa index_methodel .php 

<?php 

$dir = opendir ('. /plug-ins' ) ; // On scanne le repertoire 

// On scanne le repertoire plug-ins 
while (($file = readdir ($dir) ) !== false) { 

//Si le nom du fichier est different de . et de . . 
if($file != '.' && $file != '..'){ 
// on appelle le fichier 
require once ( ' plug- ins/ ' . $f ile) ; 

// Puis on separe le nom du fichier de son extension 

// afin de recuperer le nom de la classe 

// se trouvant dans le fichier 

list ($className, $extensionFile) = explode (".", $file) ; 

// On appelle la classe qui se trouve dans le fichier 
$oRC = new Ref lectionClass ($className) ; 

// On verifie que la classe possede bien 
// la methode ' aj outerLien ( ) ' 
$oRC->hasMethod('ajouterLien' ) 
? $lien = 'true' : $lien = 'false'; 

if($lien == 'true') { // Si c'est le cas 
$oCN = new $className; 

// On ajoute le lien dans la page web 
// en fonction des informations 
// recuperees dans la classe 
// par les proprietes de classe 
echo '<a href="'. $oCN->leLien .'" />' . 
$oCN->laDescriptionDuLien .'</axbr/>' ; 
} 
} 
} 

closedir ($dir) ; 
?> 
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Tel que programme dans cet exemple, il est primordial que le nom de la classe soit 
identique au nom du fichier. Voici la definition de la classe Micro Applications. php a 
inserer dans le repertoire plug-ins qui permet d'ajouter dans la page d'accueil de 
1' application un lien externe (a 1' application) qui pointe vers le site Internet de 
Micro Application : 



^j MicroApplications.php 


<?php 




/** 




* Cette 


classe est en fait un plug-in 


* IMPORTANT : 11 est PRIMORDIAL que le nom de la classe 


* soit identique au nom du fichier sans 1' extension .php 


* et en 


respectant la meme casse 


* Cette 


classe est appelee par un fichier qui 


* utilise la methode de reflexion pour recuperer 


* les informations necessaires 
* 


*/ 

class MicroApplications { 


public 


$leLien = 'http://www.microapp.com/'; 


public 


$laDescriptionDuLien = 'MicroApplications'; 


public 


function construct (){ } 


public 


function destruct(){} 


public 
} 


function a j outerLien ( ) { } 


?> 





Ce premier exemple est une solution mais elle n'est pas tres efficace. Imaginez le nombre 
de fois que vous allez appeler la fonction require_once() dans la boucle si vous avez 
pres d'une centaine de plug-ins d'installes. La quantite de ressources consommee serait 
tres grande et le temps d'affichage de la page s'en trouverait nettement augmente. 
Pourquoi cet exemple alors ? Pour vous rappeler que la premiere bonne solution trouvee 
n'est pas forcement la meilleure. Elle est certainement valable puisque cela fonctionne et 
appelle bien les bons plug-ins. Cependant, elle est loin d'etre la meilleure. Voyez tout de 
suite la deuxieme methode. 
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Deuxieme methode : visez I'efficacite 

Dans l'exemple qui suit, des que le script trouve un fichier, il utilise la fonction expl ode() 
afin de separer dans le nom du fichier Taction a effectuer du nom de la classe qui decrit 
precisement ce que va faire le fichier. Et c'est ce prefixe qui va dire quelle est Taction que 
va effectuer le plug-in : ajouter un lien externe, un lien interne, manipuler des donnees 
SQL, et/ou toute autre manipulation que vous aurez definie dans votre projet. Si le nom 
du prefixe correspond a Taction ajouterLien, alors on execute Taction qui va ajouter 
dans la partie de la page le lien qui va pointer vers le site Internet distant. Voici le script 
qui appelle les plug-ins concernes : 



^* index_methode2.php 



<?php 

$file = " ; 

$dir = opendir ('. /plug-ins' ) ; // On scanne le repertoire 

// On scanne les repertoires 

while (($file = readdir ($dir) ) ! == false) { 

//Si le nom du fichier est different de . et de . . 
if($file != '.' && $file != '..'){ 

// On decompose le nom de fichier pour connaitre 1' action a 

**■ effectuer 

list ($action, $filename) = explode ( "_-_", $file); 

//echo $action .'<br/>'; 

if($action == ' aj outerLien' ) { 

require once (' plug-ins/ ' . $file); 

// Puis on separe le nom du fichier de son extension 

// afin de recuperer le nom de la classe se trouvant dans le 

*» fichier 

list ( $className, $extensionFile) = explode (".", $filename) ; 

// On appelle la classe qui se trouve dans le fichier 
$oRC = new Ref lectionClass ($className ) ; 

$oCN = new $className; 

// On ajoute le lien dans la page web 

// grace a la methode invoke ( ) 

$method = new Ref lectionMethod ($className, 'ajouterLien'); 

echo $method->invoke ($oCN, 'ajouterLien', true) ; 
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closedir ($dir) ; 
?> 

Pour que ce script fonctionne, il faut que le fichier place dans le repertoire plug-ins 
respecte une norme de nom qui est action_-_nomclasse.php (exemple : 
ajouterLien_-_MicroApplications.php). Voici le fichier ajouterLien_-_Micro 'Applications 
.php qui contient la classe qui va ajouter dans la page web le lien qui pointera vers le site 
distant Micro Application : 

^* ajouterLien_-_MicroApplications.php 

<?php 

class MicroApplications { 

public $leLien = 'http://www.microapp.com/'; 

public $laDescriptionDuLien = 'Micro Applications'; 

public function construct (){ } 

public function destruct ( ) { } 

public function ajouterLien ( ) { 

return ' <a href="'. $this->leLien .'" />' . 
$this->laDescriptionDuLien . '</a>' ; 
} 
} 

?> 

Les autres methodes 

En fait, vous avez le choix entre creer un fichier par lien ou placer tous les liens dans une 
table avec pour cle l'adresse Internet et pour valeur la description du lien que vous 
recupererez grace a la methode ajouterLi en () dans laquelle vous ecrivez les instructions. 
L'avantage de cette methode est que vous n'ouvrez qu'un seul fichier, ce qui rend la 
procedure beaucoup plus rapide. Seul inconvenient, quand vous desirez ajouter un lien 
supplemental, vous devez retourner dans le code du fichier place dans le repertoire 
plug-ins. 

H existe bien d' autres methodes pour creer des systemes de plug-ins. II vous revient 
d'optimiser cet exemple, voire de le traiter de facon completement differente. Les deux 
methodes que nous vous avons presentees n'utilisent pas les bases de donnees. Cela peut 
etre une solution pourtant bien efficace si les tables SQL sont bien pensees. Vous pouvez 
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egalement melanger tout un ensemble de techniques comme la reflexion avec le codage 
dynamique via Runkit et des interfaces graphiques via XSLT. Cela permet de mettre deux 
equipes sur un gros projet : l'une se consacrera aux interfaces graphiques et l'autre a 
revolution de la programmation des fonctionnalites supplementaires a venir dans le 
projet via le systeme de plug-ins qui recupere egalement les fichiers XSLT pour 
l'affichage des donnees et ce, sans qu'aucune des deux equipes influe negativement sur 
l'autre. Et ce qui fonctionne pour deux equipes peut fonctionner pour trois ou plus. 
Developper cette idee necessiterait un ouvrage a part probablement bien plus volumineux 
que celui-ci. Un jour peut-etre... 

8.6 Check-list 

Dans ce chapitre, nous avons vu : 

«/ ce qu'est la reflexion ; 

s/ comment sont constitutes l'API de reflexion et les classes qui la composent ; 

v/ comment analyser du code avec les differentes classes de l'API de reflexion ; 

>/ les differentes classes disponibles avec l'API de reflexion ; 

>/ comment creer un systeme de plug-ins via l'API de reflexion. 
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9.2 Check-list 271 



Soulager 
e serveur 
avec le cache 




A PC, pour Alternative PHP Cache (Cache PHP 
alternatif), va nous permettre d'alleger 
considerablement les taches du serveur en conservant en 
memoire (cache) differentes variables, ce qui nous 
permettra de stacker les resultats des requetes SQL. Le 
serveur n'aura done pas a effectuer ces requetes et se 
contentera de generer la page. Bref, e'est un gain de 
temps (et de puissance) considerable. 



Soulager le serveur avec le cache 



9.1 APC, tout simplement 

Ann d'entrer en contact avec APC, nous allons rediger un petit script qui stockera une 
variable dans le cache, qui l'afnchera, puis l'effacera. 

Dans un dossier nomme chap09, creez le fichier apcjtest.php et remplissez-le comme 
suit : 



** 


apcjest.php 










<?php 












$maVariable = ' coucou' ; 










echo 


"maVariable : "; 










echo 


ape fetch ('maVariabl 


e')) 


;//n' 


ecris rien 


car 




//la variable n'est 


pas 


encore stockee. 




echo 


"<br/>"; 










ape add ( ' maVariable' , $maVari 


able 


; //stocke 


la variable 


echo 


"maVariable : "; 










echo 


ape fetch (' maVariabl 


e')) 


,7/ecris le con 


tenu 




//de la variable 










ape clear cache ( "user" 


);// 


vide 


le cache 




echo 


"<br/>"; 










echo 


"maVariable : "; 










echo 


ape fetch (' maVariabl 


e')) 


;//n' 


ecris rien 


car 




//la variable a ete 


ef facee 


du cache. 




?> 
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maVariable : 
maVariable : coucou 
maVariable : 





Fig. 9.1 : 

Seule la variable qui 
existe est affichee. 
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Dans ce premier exemple, nous utilisons trois fonctions : apc_fetch(), apc_add() et 
apc_clear_cache(). II s'agit la des trois fonctions les plus utilisees lorsque Ton travaille 
avec APC. Leur fonctionnement precis sera detaille dans la suite de ce chapitre. Pour le 
moment, nous allons ameliorer le fonctionnement du systeme de cache. 

En effet, dans notre court exemple, nous effacons immediatement la variable stockee dans 
le cache. Que se passe-t-il si nous supprimons de notre code l'appel a la fonction 
apc_clear_cache() ? 

Fig. 9.2 : 

Seul le premier appel 
(fonction apc_fetch()) ne 
renvoie rien. 











) Mozilla Firefox 






Fichier Edition Affichage 


Historique Marque-pages Outils ? 
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maVanable : 
maVanable : coucou 
maVanable : coucou 







Comme prevu, le premier appel de la fonction apc_fetch()ne renvoie rien, la variable 
$maVariable n'etant pas encore stockee dans le cache. Mais maintenant, cette variable 
restera stockee dans le cache indefiniment. Chargez une nouvelle fois cette page. 

Fig. 9.3 : 

Seul le premier appel 
affiche quelque chose. 
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maVanable : coucou 
maVanable : 
maVanable : 





Le premier appel a apc_fetch() affiche bien le contenu de notre variable, mais qu'en est-il 
des deux autres appels ? Pourquoi n'affichent-ils rien ? 



263 



Soulager le serveur avec le cache 



En fait, la fonction apc_add()met une variable en cache uniquement si celle-ci n'est pas 
deja stockee. Dans le cas ou cette variable existerait deja dans le cache, la fonction 
retourne false. La variable n'est pas supprimee mais, a 1' utilisation, cela revient 
pratiquement au meme. Remplacons done la fonction apc_add()par la fonction 
apc_store() comme suit : 

ape store (' maVariable' , $maVariable) ; //stock la variable 
Et voila, le tour est joue ! 

Un systeme de cache evolue 

Dans 1' introduction de ce chapitre, nous avons pris l'exemple d'un forum. C'est 
exactement ce que nous allons faire maintenant arm de penetrer plus avant dans 
l'utilisation d'APC. Nous n'allons pas, bien evidemment, en creer un entierement, nous 
allons seulement nous interesser a la generation des pages. 

Pour ce faire, nous allons creer une base de donnees, que nous appellerons forum, et n'y 
ajouter qu'une seule table (nommee fil) que voici : 

CREATE TABLE 'forum', 'fil' ( 

' id' INT NOT NULL AUTO_INCREMENT PRIMARY KEY , 

'message' TEXT NOT NULL 



Voici maintenant, d'un bloc, le fichier apc_forum.php, que nous allons modifier petit a 
petit tout au long de ce chapitre : 



^^ apc_forum.php 



<?php 

$tempsDebut = microtime (true) ; 

// Parametres mysql a remplacer 

def ine ('DB_SERVER' , ' localhost' ) ; // serveur mysql 

define ( ' DB_SERVER_USERNAME' , 'root'); // nom d' utilisateur 

define ( ' DB_SERVER_PASSWORD' , " ) ; // mot de passe 

def ine (' DB_DAT ABASE' , 'forum'); // nom de la base 

$connect = mysql connect (DB SERVER, 

DB_SERVER_USERNAME, 

DB_S ERVER_PAS SWORD ) 
or die (' Impossible de se connecter : ' . mysql error ()); 
mysql_select_db (DB_DATABASE, $connect) ; 
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if ($_GET[' action' ] == "ajouter"){ 

$sql = "INSERT INTO 'f orum' . 'f il' ('id', 'message')"; 
$sql .= "VALUES (NULL , '". $_POST [' message ']."')" ; 

if ( !mysql_query ($sql) ) { 

echo "le message n' a pas ete ajoute..."; 
} 
} 

af ficheFil () ; 

af f icheFormulaire ( ) ; 

function piedHTML(){ 

echo "\n</body>\n</html>"; 
} 

function af ficheFil () { 

$sql = "SELECT * FROM 'fil' "; 

$resultat = mysql_query ($sql) ; 

if (!$resultat) { 

echo "La requete a echoue."; 

} else { 

af f icheMessage ($resultat) ; 
} 
} 

function aff icheMessage ($r) { 
$resultat = "<table>"; 

while ($line = mysql_fetch_assoc ($r) ) { 
$resultat .= "<tr>" ; 
foreach ($line as $col_value) { 

$resultat .= "<td>$col_value</td>" ; 
} 

$resultat .= "</tr>"; 
} 

$resultat .= "</table>"; 
echo utf 8_decode ($resultat) ; 
} 

function aff icheFormulaire () { 

echo '<form method="post" action="apc f orum.php?action=ajouter">' ; 
echo '<textarea name="message" rows="5" cols="40"x/textarea>' ; 
echo '<input type="submit" value="Ajouter" />' ; 
echo '</form>'; 
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} 

$tempsFin = microtime (true) ; 
$temps = $tempsFin - $tempsDebut ; 

echo utf8 decode ( "duree de l'execution : ".$temps." secondes"); 
?> 



Comme vous pouvez le constater, ce fichier n'est pas un modele de programmation pour 
la communication avec mySQL, mais ce n'est pas le but ni de ce chapitre ni de cet 
ouvrage. 

Fig. 9.4 : 

Un minuscule extraitd'un 
petit forum 




<£ *- . - © ■ 12 H 



http://localriost/dynamisez%2uPHP/chapl 



[j http://localhos...9/apc_forum.php Q ^ localhost / localhost / forum / 



1 le premier message du forum 

2 un deuxieme message ! ! ! ! 

3 un troisieme message 

4 Et encore un autre message 




duree de 1' execution : 0.0032289028 1677 secondes 



Notez la presence d'un chronometre qui va nous permettre d'evaluer APC. 

Creons maintenant un autre fichier que nous appellerons apcjemoin.php, puis copions-y 
le contenu du fichier apc_forum.php. De cette maniere, nous pourrons toujours comparer 
les performances du fichier apc_forum.php, que nous modifierons en utilisant avec APC, 
celles du fichier apc_temoin.php. 

Mettre des reponses a des requetes SQL dans le cache 

La premiere modification que nous allons effectuer concerne le resultat de la requete 
SQL. Avant d'appeler la fonction afficheFi 1 (), la fonction qui execute la requete SQL, 
notre fichier se doit de verifier qu'il n'y a pas deja un resultat dans le cache. Modiflons-le 
done ainsi : 
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if (apc_fetch (' stock' ) != 'en stock' ) { 

aff icheFil () ; 
} else { 

$html = apc_f etch (' resultat' ) ; 

echo utf8_decode ($html) ; 
} 
af f icheFormulaire ( ) ; 



Grace a la fonction apc_fetch(), notre programme commence par regarder si la variable 
de cache stock existe. II faut maintenant que notre fichier cree dans le cache contienne 
le resultat de la requete SQL. Nous allons done rajouter quelques lignes a notre fonction 
afficheMessage() : 



function af f icheMessage ($r ) { 
$resultat = "<table>"; 

while ($line = mysql_fetch_assoc ($r) ) { 
$resultat .= "<tr>" ; 
foreach ($line as $col_value) { 

$resultat .= "<td>$col_value</td>" ; 
} 

$resultat .= "</tr>"; 
} 

$resultat .= "</table>"; 
echo utf 8_decode ($resultat) ; 

apc_store (' resultat' , $resultat) ; //stocke la variable 
apc_store (' stock' , 'en stock'); 
} 



La fonction apc_store() stocke nos deux variables de cache resul tat et stock. Cela fait, 
notre programme stocke la reponse de la requete SQL dans le cache, et ne l'executera 
plus. Nous remarquons pourtant que, meme lorsque notre programme ne fait pas de 
requete, il se connecte quand meme a la base de donnees. Nous regions done ce leger 
probleme comme suit : 




567 



Soulager le serveur avec le cache 



if ($_GET['action' ] == "ajouter"){ 
connexion ( ) ; 

$sql = "INSERT INTO 'forum'.'f il' ('id', 'message')"; 
$sql .= "VALUES (NULL , '". $_POST [' message ']•"')" ; 

if ( !mysql_query ($sql) ) { 

echo "le message n' a pas ete ajoute..."; 
} 
} 

if (apc_fetch (' stock' ) != 'en stock' ) { 

aff icheFil () ; 
} else { 

$html = apc_f etch (' resultat' ) ; 

echo utf 8_decode ($html) ; 
} 



function connexion () { 

$connect = mysql connect (DB SERVER, 

DB_SERVER_USERNAME, 
DB_S ERVER_PAS SWORD ) 
or die (' Impossible de se connecter : ' . mysql_error ( ) ) 

mysql_select_db (DB_DATABASE, $connect) ; 



Essayons maintenant, grace a apc_forum(), de rajouter un message a notre fil de 
discussion. Comme vous pouvez le verifier, notre nouvelle entree n'apparait pas dans 
notre mini-forum. Pourtant, notre nouveau message a correctement ete enregistre dans la 
base de donnees... C'est normal. Notre variable etant deja dans le cache, la requete SQL 
n'est pas effectuee. Nous avons plusieurs alternatives pour regler ce probleme. 

Nous pouvons par exemple vider le cache au moment de la requete SQL 
d'enregistrement, grace a la fonction apc_clear_cache() : 



if ($_GET['action' ] == "ajouter"){ 
connexion ( ) ; 

$sql = "INSERT INTO 'forum'.'f il' ('id', 'message')"; 

$sql .= "VALUES (NULL , '". $_POST [' message ']."')" ; 

if ( !mysql_query ($sql) ) { 

echo "le message n' a pas ete ajoute..."; 
} 
apc_clear_cache ( "user" );//vide le cache 
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Ou alors, nous pouvons ajouter un troisieme argument a la fonction apc_store() : 



function af f icheMessage ($r ) { 
$resultat = "<table>"; 
while ($line = mysql_fetch_assoc ($r) ) { 

$resultat .= "<tr>" ; 

foreach ($line as $col_value) { 

$resultat .= "<td>$col_value</td>" ; 

} 

$resultat .= "</tr>"; 
} 

$resultat .= "</table>"; 
echo utf 8_decode ($resultat ) ; 

apcstore (' resultat' , $resultat, 5);//stocke la variable 
apc_store (' stock' , 'en stock', 5); 



En procedant de cette maniere, les variables de cache resultat et stock seront effacees 
au bout de cinq secondes (ou plutot au moment de la requete suivante, si celle-ci apparait 
apres cinq secondes). Ce troisieme argument peut aussi etre ajoute a la fonction 
apc_add(). 

APC et les constantes 

Au tout debut de notre fichier apc_forum.php, nous definissons un certain nombre de 
constantes que nous utilisons pour la connexion a la base de donnees. II n'est cependant 
pas judicieux de les redefinir a chaque chargement de notre programme. 

APC permet la mise en cache des constantes et est meme un peu plus rapide que 
define (). Nous allons done modifier notre code arm qu'il integre cette fonctionnalite. 
Modifiez-donc apc_forum.php de la maniere suivante : 



if (. 


ape 


load constants (' 


constantes' 


) ) { 


// 


Parametres mysql a 


remplacer 




$constantes = 


= array ( 








'DB 


SERVER' 


=> 'loca 


lhost' , 






'DB 


SERVER 


USERNAME' 


=> 'root', 






' DB 


SERVER 


PASSWORD' 


=> ", 
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' DB DATABASE', 'forum' 



) ; 

apc_def ine_constants ( ' constantes' , $constantes) 



if (apc_fetch (' stock' ) != 'en stock' ) { 



En passant un tableau contenant toutes les constantes et une cle d' indexation a la fonction 
apc_define_constants() , nous les stockons dans le cache. Pour les appeler depuis le 
cache, nous utilisons simplement la fonction apc_load_content()... 

Voyez maintenant la difference de performance entre les fichiers apcjtemoin.php et 
ape _forum.php . 



Fichier Edition Affichage Historique Marque-pages Outils ? 



^> 



fjjfc | Q| http://localhost/dynamisez%20PHP/chap< 



monok Jjj flex 3 reference Animeka 



Q http://localhost/d...ap09/apc_forurn.php Q http://localhos.../apc_t( 



1 le premier message du forum 

2 un deuxieme message ! ! ! ! 

3 un troisieme message 

4 Et encore un autre message 

5 coucou ! je suis ici ! 

6 youpi tralala 

7 encore un message qui ne dit nen 

8 Grunt! 
9 

10 iln'y a nen dans le message nurnero 9 !!! 

11 un onzieme message... 

12 J'aime bienrajouter des messages quine veulent nen dire.. 

13 Ooooohyeah ! 

14 message 



► Fig. 9.5 : 

Le fichier 

apcjemoin.php met un 
certain temps a 
s'afficher. 
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1 le premier message du forum 

2 un deuxieme message ! ! ! ! 

3 un troisieme message 

4 Et encore un autre message 

5 coucou ! je suis ici ! 

6 youpi tralala 

7 encore un message qui ne dit nen 

8 Grunt! 
9 

10 iln'y a nen dans le message nurnero 9 !!! 

11 un onzieme message... 

12 J'aime bienrajouter des messages quine veulent nen dire.. 

13 Ooooohyeah ! 

14 message 
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Fig. 9.6 : 

Le fichier apc_forum.php 
que nous avons modifie 
est beaucoup plus 
rapide, meme avec 
seulement 14 messages. 




9.2 Check-list 

Apres avoir lu ce chapitre, utiliser le cache avec APC est devenu chose aisee. 

Nous avons vu : 

*/ comment charger des variables en memoire cache grace aux fonctions apc_add() et 

apc_store() ; 
>/ comment acceder a des variables disponibles en memoire cache ; 
</ comment enregistrer et lire des constantes depuis la memoire cache. 
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Compiler 
e code PHP 




B compiler permet de compiler votre code PHP. Mais a 
quoi cela sert-il ? Tout simplement a proteger vos lignes 
de code si durement creees a la sueur de votre front. En 
effet, les fichiers compiles par Bcompiler sont illisibles pour 
un etre humain, mais parfaitement utilisables par un 
ordinateur. Vous pouvez ainsi diffuser vos fichiers PHP 
compiles sans craindre pour leur integrite. 



lO Compiler le code PHP 



1 0. 1 Creer du bytecode 
Compiler un fichier 

Afin de s'initier a Bcompiler, nous allons commencer par le plus simple : la compilation 
d'un fichier PHP complet. 

Dans un dossier intitule chaplO, nous allons creer un dossier bytecode ainsi que les 
fichiers bcompiler Jichier.php et bcompiler _fichier_proprietaire.php. 

Voici le contenu de bcompiler _fichier_proprietaire.php : 

^j bcompiler_fichier_proprietaire.php 

<?php 

$secret = "mot de passe hyper secret"; 

echo "mon fichier PHP<br/>\n" ; 

?> 

Si Ton invoque ce fichier via la commande include, la phrase "mon fichier PHP" 
apparaitra simplement a l'ecran. 

Le second fichier, bcompiler Jichier.php va seulement nous servir a compiler le fichier 
bcompiler _jichier_proprietaire.php, puis a afficher son contenu : 

$^ bcompiler_fichier.php 

<?php 

// adresse du futur fichier compile : 

$bytecode = "bytecode/bcompiler fichier proprietaire .phb" ; 

// adresse du code source : 

$codeSource = "bcompiler fichier proprietaire. php" ; 

// creation du fichier compile : 

$f ichierBytecode = f open ($bytecode, "w"); 

// ecriture de l'en-tete du fichier : 
bcompiler write header ($f ichierBytecode) 



//ecriture du corps du fichier : 

bcompiler write file ($f ichierBytecode, $codeS 

// ecriture du pied de page du fichi 
bcompiler write footer ($f ichierBytecc 



ource) ; 



i_er : 
tecode) 
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// fermeture du fichier : 
fclose ($f ichierBytecode) ; 

// appel du fichier compile : 

include ' bytecode/bcompiler fichier proprietaire .phb' 

?> 



Lorsque vous lancez ce fichier, la phrase "mon fichier PHP" apparait comme convenu a 
l'ecran : le fichier de bytecode a bien ete cree. Vous pouvez remarquer F extension de ce 
nouveau fichier : .phb, comme "PHp Bcompiler" ; mais il ne s'agit la que d'une 
convention. Nous aurions pu choisir n'importe quelle autre. 

Les etapes pour creer un fichier de bytecode sont assez simples. D'abord, nous creons le 
fichier lui-meme, via la fonction fopen()Ensuite, nous ecrivons le contenu du fichier via 
les fonctions bcompiler_write_header(), bcompiler_write_file() et bcompiler_write 
_footer(). Nous en deduisons done qu'un fichier de bytecode, comme n'importe quel 
fichier, dispose d'un en-tete, d'un corps et d'un pied de page. 

Attardons-nous un peu sur ce fichier de bytecode : ouvrons-le avec un editeur de texte, tel 
que Notepad. Que voyons-nous ? Des carres et des espaces a foison. Ainsi, notre code est 
protege. Et pourtant... Si nous regardons un peu plus attentivement, nous voyons tres 
lisiblement ecrite la chaine de caracteres "mon fichier PHP", ainsi que le contenu de la 
variable $secret. C'est tout a fait normal : une chaine de caracteres n'etant pas, a 
proprement parler, du code, il serait absurde de tenter de la compiler. . . II ne faut done pas 
laisser de donnees sensibles, comme un mot de passe, par exemple, dans un fichier de 
bytecode, a moins de les crypter au prealable. 

Comparons maintenant le poids du fichier de bytecode et celui du fichier source : 

Fig. lO.l : 

Notre fichier source 
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bcompiler fichier_proprietaire. . . . 
Fichier PHP 
1 Ko 




















bcornpiler_f ichier_proprietaire . php 
Type : Fichier PHP 

Date de modification : 25/08/2007 19: 10 
Taille : 81 octets 
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bcompiler fichier_proprietaire. . . . 
Fichier PHB 
1 Ko 




















bcompiler_f ichier_proprietaire . phb 
Type : Fichier PHB 

Date de modification : 25/08/2007 19:09 
Taille : 412 octets 
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Fig. 10.2: 

Notre fichier compile 
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Vous vous rendez compte que le fichier de bytecode pese environ cinq fois plus lourd que 
le fichier source ! C'est helas le prix a payer pour proteger ses algorithmes. 

Test de vitesse 

Nous allons maintenant comparer la vitesse d' execution d'un fichier de bytecode et du 
fichier source. Pour ce faire, nous allons creer trois fichiers : bcompiler_vitesse.php, 
bcompiler_vitesse_ouvert.php et bcompiler_vitesse_secret.php. 



<^ bcompiler_vitesse_ouvert.php 



<?php 

function ouvert(){ 

for($i = ; $i < 100000 ; $i++) { 
$a = $i." : ".sqrt ($i*5) . "<br/>\n"; 

} 
} 
?> 

Ce fichier ne contient qu'une seule fonction dont le but avoue est de faire travailler le 
processeur un certain temps. 

$^£ bcompiler_vitesse_secret.php 

<?php 

function secret (){ 

for($i = ; $i < 100000 ; $i++) { 
$a = $i." : ".sqrt ($i*5) . "<br/>\n"; 

} 
} 
?> 

Le fichier bcompiler_vitesse_secret.php a exactement le meme but que le fichier 
bcompiler_vitesse_ouvert.php, a ceci pres qu'il va etre compile. 

Enfin, voici le code du troisieme fichier (bcompiler_vitesse.php) : 



fl^jt bcomp 


ler. 


vitesse 


php 








<?php 














// adresse 


du 


futur 


fichier 


compile : 






$bytecode = 


" 


oyteco 


de/bcompi 


ler fonctions 


secret 


phb"; 


// adresse 


du 


code 


source : 








$codeSource 


= 


"bcompiler fonctions secret 


php"; 
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// creation du fichier compile : 

$f ichierBytecode = f open ($bytecode, "w" ) ; 

// ecriture de l'en-tete du fichier : 
bcompiler write header ($f ichierBytecode) ; 

//ecriture du corps du fichier : 

bcompiler write file ($f ichierBytecode, $codeSource) ; 

// ecriture du pied de page du fichier : 
bcompiler write footer ($f ichierBytecode) ; 
fclose ($f ichierBytecode) ; 

echo "poids avant compilation : <b>" . f ilesize ($codeSource) ." 
**• octets</bxbr/>"; 

include 'bcompiler fonctions ouvert .php' ; 

include ' bytecode/bcompiler_fonctions secret .phb' ; 

$tempsDebut = microtime (true) ; 
ouvert ( ) ; 

$tempsFin = microtime (true ) ; 
$temps = $tempsFin - $tempsDebut; 

echo "Nous avons mis <b>$temps</b> secondes avec le code 
*» source .<br/>\n" ; 

echo "poids apres compilation : <b>" . f ilesize ($bytecode) . " 
*» octets</b>.<br/>"; 

$tempsDebut = microtime (true) ; 
secret ( ) ; 

$tempsFin = microtime (true) ; 
$temps = $tempsFin - $tempsDebut; 

echo "Nous avons mis <b>$temps</b> secondes avec le bytecode. <br/>\n"; 

?> 

Ce dernier fichier va compiler bcompiler_vitesse_secret.php, puis executer les deux 
fonctions et comparer les vitesses d'execution de l'une et de l'autre, ainsi que le poids du 
fichier source et du fichier de bytecode. 

Voici les resultats obtenus lorsque nous lancons ce script depuis la machine sur laquelle 
nous ecrivons : 



E77 
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£>MozillaFirefox 



Fichier Edition Affichage Historique Marque-pages Outils ? 
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poid avant compilation : 111 octets 

Nous avons mis 0.340789794922 secondes avec le code source. 

poid apres compilation : 1228 octets. 

Nous avons mis 0.333310842514 secondes avec le bytecode. 



Fig. 10.3: 

Resultatdu script 



Nous pouvons voir qu'un fichier de bytecode n'est pas execute plus rapidement que s'il 
n'avait pas ete compile. 

Compiler des classes et des fonctions 

Les fonctions 

Bcompiler, en plus de permettre la compilation complete d'un fichier, permet de n'en 
compiler que certaines fonctions. Cela est tres pratique pour obtenir un fichier compile 
contenant quelques utilitaires. 

Nous allons done, toujours dans notre dossier chaplO, creer deux nouveaux fichiers. Le 
premier, bcompiler_fonction_source.php, contiendra le code source de quelques fonctions 
et les compilera. Le second, bcompiler _fonction.php, nous servira a tester le fichier de 
bytecode genere par le premier fichier. 

Voici le code de notre premier fichier : 

<^ bcompiler_fonction_source.php 

<?php 

// adresse du futur fichier compile : 
$bytecode = "bytecode/bcompiler_f onction.phb" ; 

// Creation du fichier compile 

$f ichierBytecode = f open ($bytecode, "w") ; 

// ecriture de l'en-tete du fichier : 
bcompiler write header ($f ichierBytecode) ; 

// ecriture des fonctions au sein du fichier compile 
bcompiler write function ($f ichierBytecode, "phraseEnCouleur" ) ; 
bcompiler_write_f unction ( $f ichierBytecode, "aj out Phrase " ) ; 
bcompiler write function ($f ichierBytecode, "ecritPhrase" ) ; 
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// ecriture du pied de page du fichier : 
bcompiler write footer ($f ichierBytecode) ; 
fclose ($f ichierBytecode) ; 

// les fonctions a compiler : 

function phraseEnCouleur ($phrase = "Phrase par defaut", 

$couleur = "#DE0059") { 
return ' <div style="color :'. $couleur .'">'. $phrase .' </div>' ; 
} 

function aj outPhrase ( &$tab, $phrase){ 

$tab[] = $phrase; 
} 

function ecritPhrase ( &$tab) { 

for($i = ; $i < count ($tab) ; $i++) { 
echo $tab [$i] ; 

} 
} 
?> 

Dans ce fichier, nous utilisons differents types de fonctions : avec ou sans valeur de 
retour, avec des arguments disposant ou non de valeur par defaut ou avec des arguments 
passes par references. 

Ann de les ecrire dans le corps du fichier de bytecode, nous utilisons la fonction 
bcompi ler_write_f unction () pour chacune de nos fonctions. 

Regardons maintenant le simplissime code du fichier bcompiler_fonction.php : 

^£ bcompiler_fonction.php 

<?php 

include ' bytecode/bcompiler fonction. phb' ; 

$tableau = array () ; 

$str = phraseEnCouleur ("Salut a vous !<br/>La forme ?", "#455FDB"); 

aj outPhrase ($tableau, $str) ; 

aj outPhrase ($tableau, phraseEnCouleur ( ) ) ; 

ecritPhrase ($tableau) ; 

?> 

L'utilisation est plutot simple, n'est-ce pas ? 

Cela dit, imaginez que vous ayez une cinquantaine de fonctions a compiler : il serait 
vraiment fastidieux d'ecrire cinquante fois la fonction bcompi ler_write_functi on (). Si 
toutes vos fonctions se trouvent au sein d'un meme fichier, vous pouvez utiliser la 
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fonction bcompi 1 er_wri te_functions_from_fi le(). En une seule ligne, toutes les 
fonctions d'un meme fichier seront compilees et ajoutees au bytecode. 

Ouvrons a nouveau le fichier bcompiler_fonction_source.php, et remplacons les trois 
appels a la fonction bcompi ler_write_functi on ()par cette seule ligne : 

Bcompiler write functions from f ile ( $f ichierBytecode, 
*» 'bcompiler fonction source. php' ) ; 

Le tour est joue. II ne reste plus qu'a compiler notre fichier de bytecode (en lancant le 
fichier bcompiler_fonction_source.php), et a executer de nouveau le fichier 
bcompiler _fonction.php pour s' assurer que tout fonctionne bien. 

Les classes 

Bcompiler met aussi a notre disposition un outil pour compiler des classes. Ann d'illustrer 
notre propos, nous allons creer deux fichiers : bcompiler _class_source. php et 
bcompiler _class.php. Le premier contiendra le code de quelques classes ainsi que les 
quelques lignes necessaires a leur compilation. Le second servira bien sur a tester le 
fichier de bytecode. 

Q&, bcompiler_class_source.php 

<?php 

// adresse du futur fichier compile : 
$bytecode = "bytecode/bcompiler_class .phb" ; 

// Creation du fichier compile 

$f ichierBytecode = f open ($bytecode, "w") ; 

// ecriture de l'en-tete du fichier : 
bcompiler write header ($f ichierBytecode) ; 

// ecriture des classes au sein du fichier compile 
bcompiler^write class ($fichierBytecode, "Animal"); 
bcompiler write class ($f ichierBytecode, "Mammif ere" ) ; 

// ecriture du pied de page du fichier : 
bcompiler write footer ($f ichierBytecode) ; 
f close ($f ichierBytecode) ; 

// les classes a compiler : 
class Animal { 

public $nom; 
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function construct ($nom) { 

$this->nom = $nom; 
} 

function presentation () { 

return ' Je suis : <b>' . $this->nom. '</b>' ; 
} 

function seFaitManger ($animal) { 

return $this->nom." : V'Rosebud !\"<br/>"; 
} 



class Mammifere extends Animal { 

public $regime; 

function construct ($nom, $regime) { 

parent: : construct ($nom) ; 

$this->regime = $regime; 



function presentation () { 

return parent : presentation ( ) . 
' . Mon regime : <b>' . 
$this->regime . '</b>' ; 
} 

function mange ( $animal ) { 
return $this->nom. 

' est en train de manger ' . 
$animal->nom. "<br/>" . 
$animal->seFaitManger ( $this ) ; 
} 
} 

?> 

Dans cet exemple, nous utilisons deux classes : Animal et Mammi fere. La classe Mammi fere 
heritant de la classe Animal , il est necessaire de compiler d'abord Animal , puis Mammi fere. 
Essayons de compiler de cette maniere : 

bcompiler write class ($f ichierBytecode, "Mammifere"); 
bcompiler^write class ($f ichierBytecode, "Animal"); 

Ce code genere une erreur car la classe Mammifere ne trouve pas sa classe mere dans le 
bytecode ! 
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Une fois que nous avons execute ce fichier (avec les classes dans le bon ordre), le fichier 
bcompiler _class.phb a ete cree. Testons-le done : 



fl^j bcompiler_class.php 

<?php 

include ' bytecode/bcompiler_class .phb' ; 

$bestiole = new Animal ( "lapin" ) ; 

echo $bestiole->presentation ( ) . "<br/>"; 

$bestiole2 = new Mammif ere ("tigre" , "carnivore"); 

echo $bestiole2->presentation ( ) . "<br/>"; 

echo $bestiole2->mange ($bestiole) ; 

?> 

Comme pour la compilation de fonctions, 1' usage est relativement simple. Cependant, 
Bcompiler n'offre pas de fonction permettant en une seule ligne de code la compilation 
de toutes les classes d'un fichier : en effet, rien ne lui indiquerait quelle classe descend 
de quelle autre, et Bcompiler ne peut pas le deduire tout seul. 



10.2 Lire le bytecode 



Jusqu'a present, nous avons toujours utilise include pour lire le contenu d'un fichier de 
bytecode. Les commandes include et require resteront les manieres les plus simples et 
les plus portables d'utiliser un fichier compile. Mais il existe d'autres methodes. 

Par exemple, renommons le fichier bcompiler Jichier_proprieta.ire.phb (qui devrait se 
trouver dans votre repertoire bytecode) en bcompiler _fichier_proprietaire.php : nous 
changeons seulement l'extension. Ouvrez ensuite ce fichier depuis votre navigateur 
prefere. Comme il s'agit la d'un simple script pouvant fonctionner seul, le navigateur 
affiche bien la phrase "mon fichier PHP". 

Un fichier compile, pour peu qu'il porte l'extension .php, peut done etre lu directement. 

La fonction bcompiler_read() 

Nous pouvons acceder au contenu d'un fichier compile grace a la fonction 
bcompi ler_read(). Cette fonction, contrairement aux structures include ou require, 
n' execute pas le code contenu dans le fichier. 

Creons done un fichier bcompiler _lire. php. Ce fichier devra ouvrir trois fichiers de 
bytecode (l'un contenant un script, l'autre des fonctions et le dernier des classes. Si vous 
avez fait chaque exemple de ce chapitre, vous disposez deja de ces fichiers : 
bcompiler _fichier_proprietaire. phb pour le fichier de script, bcompiler _fonction.phb pour 
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le fichier de fonctions et bcompiler_class.phb pour le fichier de classes), puis tenter d'en 
executer le contenu. Voici le code de bcompilerjtire.php : 



*^ bcompilerjire.php 



<?php 

// ouverture du fichier de bytecode contenant un script 

$f ichierBytecode = fopen ( "bytecode/bcompiler_f ichier_proprietaire . phb", "r") ; 

bcompiler read ($f ichierBytecode) ; 

fclose ($f ichierBytecode) ; 

// essai de lecture d' une variable contenue dans le script 
echo $secret; 

// ouverture du fichier de bytecode contenant des fonctions 
$f ichierBytecode = fopen ("bytecode/bcompiler f onction.phb", "r" ) ; 
bcompiler read ($f ichierBytecode) ; 
fclose ($f ichierBytecode) ; 

// essai d' utilisation de ces fonctions 

$tableau = array () ; 

$str = phraseEnCouleur ("Salut a vous !<br/>La forme ?", "#455FDB"); 

aj outPhrase ($tableau, $str) ; 

aj outPhrase ($tableau, phraseEnCouleur ( ) ) ; 

ecritPhrase ($tableau) ; 

// ouverture du fichier de bytecode contenant des classes 
$f ichierBytecode = fopen ("bytecode/bcompiler_class . phb" , "r" ) ; 
bcompiler read ($f ichierBytecode) ; 
fclose ($f ichierBytecode) ; 

// essai d' utilisation de ces classes 

$bestiole = new Animal ( "lapin" ) ; 

echo $bestiole->presentation ( ) . "<br/>"; 

$bestiole2 = new Mammif ere ( "tigre" , "carnivore"); 

echo $bestiole2->presentation ( ) . "<br/>"; 

echo $bestiole2->mange ($bestiole) ; 

?> 

Lorsque nous lancons ce fichier, nous nous rendons compte que le fichier de script ne 
s'execute pas (la phrase "mon fichier PHP" n'apparait pas a l'ecran). De plus, la variable 
$secret ne s'affiche pas non plus. Et pourtant, aucune erreur ne nous est renvoyee. 
Par contre, les fichiers de fonctions et de classes s'executent correctement. 

Quels avantages y a-t-il a utiliser cette fonction ? Si nous comparons les temps d'execution, 
nous ne pouvons noter de differences significatives. Le seul avantage est de pouvoir charger 
ces fichiers compiles en un seul et meme endroit du code, pour plus de clarte. 
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La fonction bcompiler_load() 

Comme nous l'avons vu precedemment, un fichier compile pese environ cinq fois plus 
lourd que son alter ego non compile. Heureusement, l'extension Bcompiler nous propose 
une petite fonction afin de resoudre ce probleme de poids. En effet, 
bcompi ler_load() permet de charger un fichier de bytecode compresse avec BZIP2 ! 

Vous pouvez vous reporter au chapitre Comprimez vos donnees, traitant de la 
compression, pour plus de details sur la maniere d'utiliser BZIP2. 

Nous allons, en un seul petit fichier (place dans votre repertoire chaplO), nomme 
bcompiler _bzip-php, compresser le fichier bcompiler _class.phb (si vous avez effectue les 
exemples de ce chapitre, il devrait deja exister dans le dossier bytecode) puis utiliser les 
classes contenues dans notre fichier compile-compresse. 

Voici le code de bcompiler_bzip-php : 

^ bcompiler_bzip.php 

<?php 

$f ichierSource = 'bytecode/bcompiler class. phb'; 

// recuperation, sous la forme d' une chaine 

// de caracteres, du contenu du fichier de bytecode : 

$contenu = f ile_get_contents ($f ichierSource) ; 

// on ecrit le contenu du fichier de bytecode 

// a l'ecran : 

echo "<p>"; 

echo $contenu; 

echo "</p>"; 

// On s'apergoit bien, grace a tous les caracteres 

// bizarres inscrits a l'ecran, qu' il s'agit ef f ectivement 

// du contenu du fichier de bytecode ! 

// ouverture (ou creation) du fichier compresse : 
$bzo = bzopen ( ' bytecode/compile compresse .bz2' , "w"); 

// Ecriture du code compile dans le fichier compresse : 
bzwrite ($bzo, $contenu, strlen ($contenu) ) ; 

// Fermeture du fichier compresse : 
bzclose ($bzo) ; 

// chargement des classes contenues 

// dans notre fichier compile-compresse : 
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bcompiler load (' bytecode/compile compresse .bz2' ) ; 

// Execution de ces classes : 

$bestiole = new Animal ( "lapin" ) ; 

echo $bestiole->presentation ( ) . "<br/>"; 

$bestiole2 = new Mammif ere ( "tigre" , "carnivore"); 

echo $bestiole2->presentation ( ) . "<br/>"; 

echo $bestiole2->mange ($bestiole) ; 

?> 

Et voila ! Nos classes ont ete d'abord compilees en un fichier de bytecode, puis 
compressees grace a BZIP2. A cet effet, le fichier compile_compresse.bz2 pese environ 
quatre fois moins lourd que bcompiler _class.phb, son homologue non compresse. 

Malheureusement, bcompi ler_load()ne s'utilise qu'avec des classes. Si vous esperiez 
compresser du script ou des fonctions compilees, il va falloir passer votre chemin. 

Enfin, si nous gagnons en place, nous perdons en vitesse d' execution. C'est evidemment 
normal, puisque nous subissons une etape de decompression. Un fichier compile et 
compresse met environ deux fois plus de temps qu'un autre a s'executer. 

Maintenant, c'est a vous de determiner quelle methode de compilation va etre la plus 
adaptee a votre projet : faut-il compiler du script ? Des fonctions ? Des classes ? Tout a 
la fois ? Faut-il compresser ? 

Et surtout, n'oubliez pas de vous poser la plus importante de toutes les questions : queries 
parties de mon programme sont suffisamment sensibles pour justifier leur compilation et 
la perte de performances (en termes de poids ou de rapidite d'execution) qui va avec ? 



10.3 Check-list 

Dans ce chapitre, nous avons decouvert ce qu'etait Bcompiler, ses avantages et ses 
inconvenients. 

Nous avons vu comment : 

>/ compiler vos fichiers PHP ; 

</ compiler des classes et des fonctions ; 

>/ lire des fichiers, des classes ou des fonctions compiles ; 

>/ lire des fichiers compiles et compresses. 
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Ce chapitre a pour objectif de vous donner des pistes 
afin d'etudier des extensions que vous ne connaissez 
pas encore, et ce par vous-meme. II est facile de travailler 
une extension lorsque celle-ci est documentee. Mais 
comment faire lorsqu'elle ne Test pas ? 
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11.1 Avant de commencer... 

Chacun est unique. Les auteurs sont aussi uniques que vous l'etes vous-meme. Ces deux 
premieres phrases sont la pour prevenir que, meme si les differentes ecoles essayent plus 
ou moins et tant bien que mal d'enseigner une pensee assez similaire et formatee, vous 
n'en restez pas moins des etres humains. D'ailleurs, pourquoi avez-vous choisi 
rinformatique et pas la psychologie, l'histoire ou l'ethnologie ? Tout simplement parce 
que vous avez un passe, un vecu, avec des souvenirs, des reflexes conditionnes et 
inconscients. Et c'est sans compter le sujet de la memoire cellulaire et des heritages 
transgenerationnels. Voila pourquoi vous avez choisi l'informatique au point d'en faire 
une profession ou si ce n'est pas encore le cas, de vouloir en faire une profession ou 
encore un simple loisir. Done, recuperez parmi les explications qui seront donnees dans 
ce chapitre tout ce qui vous semble etre le meilleur pour vous et laissez de cote ce qui 
vous semble inutile, inefficace, voire meme ridicule. Chacun possede son mode de 
pensee, sa logique et son ressenti. Et il y a autant de bonnes facons de faire pour atteindre 
un meme resultat escompte qu'il y a d'etres vivants. 

ConnaTtre ses motivations 

Connaitre ses besoins est la premiere chose a faire. En effet, comment peut-on evoluer si 
on ne sait pas ou Ton va ? Rappelez-vous votre passe d'ecolier, de collegien, de lyceen, 
rappelez-vous ces longs cours de mathematiques ou Ton vous apprenait a calculer une 
integrate, sans meme savoir a quoi cela pouvait servir, ou si vous alliez utiliser cette 
connaissance a l'avenir. Mais peut-etre ce jeu sans but vous amusait... 

Quoi qu'il en soit, sans motivations, vous n'irez jamais bien loin dans vos decouvertes. 
Alors, pourquoi apprenez-vous a utiliser telle ou telle extension ? Est-ce pour repondre a 
un besoin precis d'un projet ? Est-ce pour elargir le champ de vos connaissances et de vos 
competences ? Pour epater quelqu'un ? Pour vous epater vous-meme ? Est-ce tout 
simplement par jeu ? II n'y a pas de mauvaises reponses. L'important, ce n'est meme pas 
forcement de savoir pourquoi mais de savoir comment. Comment allez-vous trouver la 
bonne extension ? Comment allez-vous trouver les bonnes documentations et ne pas vous 
perdre dans un Hot de donnees inutile et consommateur de temps ? Comment allez-vous 
integrer et memoriser les informations necessaires a l'utilisation de facon naturelle, sans 
aide constante, la nouvelle extension ou API ou autre ? Comment ? 

Savoir ce que vous ne savez pas 

C'est une reflexion qui a toute son importance. Car s'il est tres facile de savoir ce que Ton 
sait, surtout consciemment, il est beaucoup plus difficile de savoir ce que Ton ne sait pas. 



2BS 



Avant de commencer... 



Et quand vous vous rendez compte d'une non-connaissance, cela s'ensuit d'un acte 
encore plus difficile, celui d'admettre et de se confronter a la realite du fait. Et plus le 
niveau du programmeur est eleve, plus il a du mal a se remettre en question. Beaucoup 
croient se remettre en question. Mais ne seraient-ils pas en train de se donner une bonne 
raison de ne pas le faire ? Se remettre en question ne signifie pas forcement avoir 
conscience de ce que Ton ne sait pas. Ne pas savoir. . . A partir du moment ou vous prenez 
conscience et que vous admettez en votre for interieur que vous ne savez pas, alors vous 
etes sur le bon chemin pour apprendre. 

Quand est-ce que c'est le plus difficile d'admettre, de nous avouer que Ton ne sait pas ? 
Quand on a pris une habitude qui fonctionnait jusque-la mais qui aujourd'hui montre ses 
limites. . . Et plus l'habitude dure depuis longtemps, moins on a envie d'admettre que c'est 
une mauvaise habitude. On a cru qu'elle etait bonne pendant des annees. Pourquoi 
aujourd'hui serait-elle mauvaise ? Parce que la vie est mouvement et que tout change a 
chaque miiliardieme de seconde. Pour ceux parmi vous qui modelisez des bases de 
donnees, tous savent que la premiere solution, aussi bonne soit-elle, n'est jamais la 
meilleure. Tout comme pour la modelisation objet. 

Apprendre une extension pour les besoins d'un projet 

Si vous devez apprendre une extension pour le bien d'un projet, la premiere question a 
se poser est celle de l'absolue necessite de l'extension en question. 

Par exemple, vous devez realiser un export de certaines donnees contenues dans une base 
au format Microsoft Excel. La reponse est deja claire : il va vous falloir apprendre COM. 
En etes-vous bien stir? N'y aurait-il pas d'autres solutions plus simples, ne vous 
imposant pas un temps d'apprentissage ? 

La reponse est oui : creez un fichier CSV (Comma-Separated Value, pour plus de 
renseignements, rendez-vous a l'adresse suivante : http://tools.ietf.org/html/rfc4180). Vous vous 
contenterez de faire de la simple concatenation de chaines de caracteres, et votre export 
sera compris par 1' immense majorite des tableurs du marche. Ce qui represente un gain 
de temps phenomenal. Sachez qu'en plus, il existe une fonction interne au moteur PHP 
nominee fgetcsv() pour exploiter au mieux et tres facilement tout fichier CSV. 

La reponse est non : vous avez besoin d'utiliser certaines fonctions propres a 
Microsoft Excel. Et en plus de cela, votre client vous a clairement signifie qu'il desirait 
un fichier au format Excel et rien d' autre. 
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Apprendre une extension pour soi-meme 

Vous avez ete exile dans une ville lointaine, ou vous ne connaissez personne. Qu'a cela 
ne tienne, vous allez approfondir vos connaissances en PHP car vous avez le materiel 
requis a disposition. Vous n'avez pas de cahiers des charges, encore moins d'objectifs ; 
il n'y a que vous face a votre liberte. Eh bien, il est vivement conseille de chasser ces 
pensees de votre esprit. C'est une erreur qu'il vous faut corriger. Et si PHP est ce qu'il 
est aujourd'hui, c'est grace a la communaute qui s'est tres rapidement formee autour de 
ce langage. La communaute de PHP est l'une des plus puissantes du monde informatique 
avec quelques autres comme Linux. 

Vous allez travailler une demi-heure en suivant un tutoriel quelconque, le temps de voir 
comment fonctionne votre extension. Et puis apres ? II vous faut un projet, quelque chose, 
meme completement inutile, au sein duquel vous allez exploiter votre extension, faire des 
experiences, tout planter, tout reussir, etc. Allez-y, faites fonctionner vos meninges, 
explorez les meandres de votre imagination. Non seulement vous allez apprendre ce que 
vous souhaitiez, mais vous allez aussi reviser vos acquis, ancrer un peu plus en vous les 
reflexes de programmation, trouver de meilleurs algorithmes que ceux que vous utilisiez 
deja. Et qui sait. .. peut-etre allez-vous avoir l'idee du siecle, celle qui changera votre vie 
(en mieux, du moins c'est ce que nous vous souhaitons) ! 

1 1 .2 Differences methodes 
Extension documentee 

Le terme "extension documentee" veut dire que l'extension est documentee dans le 
manuel officiel de PHP. Vous pouvez avoir acces a ce manuel sur le site http://php.net/. 

En ce qui concerne les extensions documentees, la methodologie reste a peu pres la 
meme. Apprendre par coeur les syntaxes de chaque fonction. Certains se disent deja : a 
quoi 9a sert ? 

Pensez-vous que vous pourriez parler francais aujourd'hui sans avoir eu a apprendre par 
coeur un certain nombre de mots de telle sorte que vous savez les employer au moment 
opportun ? II est fort probable que non et il en est de meme des regies syntaxiques et 
grammaticales. Pensez-vous que vous pourriez courir, ou sauter des obstacles si vous 
n'aviez pas appris a marcher avant ? Tout ce qui est devenu naturel pour vous a forcement 
ete appris par cceur ann de devenir inne. 

C'est exactement pared pour la programmation et done pour la programmation PHP. 
Apprenez par coeur, encore et encore. Puis pratiquez, testez durant des jours, des 
semaines. Trouvez un projet utile a programmer avec cette nouvelle extension que vous 
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etes en train d'etudier. Un projet que vous pourrez reutiliser afin de l'integrer dans un 
autre projet. Par exemple, si vous etudiez les sockets, programmez un chat. Si vous 
etudiez l'extension Crack, programmez un verificateur de mots de passe. Cherchez 
toujours un projet qui vous permet de rentabiliser le temps passe a etudier la nouvelle 
extension. 

Extension non documentee 

En ce qui concerne les extensions non documentees, il n'y a pas de methode definie. Tout 
depend de l'extension. Est-elle programmee en C puis compilee afin d'etre integree dans 
les extensions PHP ? Est-elle programmee en PHP comme le sont les paquets PEAR ? 
Est-elle programmee en POO (Programmation orientee objet) ou non ? Tout cela a son 
importance. Le premier reflexe est d'utiliser 1' introspection (ou reflexion) que vous avez 
etudiee dans le chapitre 8 avec les classes Reflection*. Puis, la plupart du temps, l'etape 
suivante est de se plonger dans les sources de l'extension, d'oii l'interet de connaitre 
egalement la programmation C. 

Si 1' introspection donne une bonne description des fonctions, alors la methode devient la 
meme que pour les extensions documentees : apprendre par coeur les fonctions et leur 
structure. Sinon, a l'etude des sources, toutes les fonctions de types publics sont 
repertoriees et sont a memoriser, par coeur. 

Dans les deux cas (reflexion ou non), les auteurs d'une extension lui cherchent une 
logique et se posent les questions suivantes : 

Comment structurer l'extension ? 

Quel peut etre son objectif ? 

Que peut-on en faire ? 

Pour quel projet, quelle application, cette extension peut s'averer utile ? 

A vous de trouver les bonnes reponses. Si vous comprenez la logique d'une extension, 
vous avez deja effectue la moitie du travail. 

Et si je ne veux pas apprendre par coeur ? 

Vous estimez que vous avez passe l'age de declamer des poesies devant le tableau noir ? 
Vous vous refusez a verifier n'importe oil n'importe quand que vous vous rappelez bien 
du fonctionnement de telle extension, de telle fonction ? Que le travail, c'est le travail, et 
que 1' apprentissage d'une nouvelle extension n'a pas a gacher votre journee ? 

Vous avez choisi la voie la plus longue. Car, pour etre certain de vos connaissances, il va 
vous falloir enchainer quelques centaines de petits projets personnels, et mettre a profit le 
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maximum de temps libre pour cela. Oui : du temps libre, car ce ne sont pas ces petits 
projets personnels qui, bien que pedagogiques, vous nourriront. Vous allez passer trois 
jours chez votre belle-famille que vous ne supportez pas ? Parfait, vous savez ce qu'il 
vous reste a faire... 

1 1 .3 Quelques conseils d'ordre general 
Apprendre de ses erreurs 

Lorsque vous travaillez sur une extension, sur un de ces petits projets qui n'ont que 
1' apprentissage pour vocation, vous allez, en plus d' apprendre de nouvelles choses, 
reviser. Vous n' allez pas utiliser que les fonctions de votre extension. Vous allez chercher 
des donnees dans une base ou dans un fichier XML, concatener des chaines, elaborer des 
algorithmes, etc. 

Toutes les manipulations que vous allez effectuer peuvent etre source d'erreurs : une 
fonction mal utilisee avec le mauvais nombre d' arguments, un algorithme sans fin, des 
erreurs de casse et ainsi de suite. 

Essayez de reperer quel est le genre d'erreurs que vous faites le plus souvent, et 
demandez-vous pourquoi. Est-ce parce que vous avez de mauvaises habitudes de 
programmation ? Ou parce que vous confondez deux mots semantiquement proches ? Ou 
bien, saturez-vous la memoire de votre serveur, jusqu'a sa capitulation ? De nombreuses 
raisons sont possibles, et il existe une solution pour chacune d'entres elles. A vous de la 
trouver arm de corriger vos erreurs tout en vous rendant plus performant, plus sur de 
vous-meme. 

Voici un bon exercice de fond, a pratiquer regulierement : reprenez vos anciens travaux 
et ameliorez leurs algorithmes, epurez votre code, raccourcissez-le le plus possible ! Vous 
ne corrigerez pas d'erreurs, mais vous vous ameliorerez dans votre maniere de concevoir 
vos algorithmes. Vous les ferez ainsi plus courts dans vos projets suivants, et done a la 
fois plus performants et plus rapides ; et, comme il y a moins de code, vous limiterez 
aussi le nombre d'erreurs possibles. 



Utiliser toute I'aide disponible 



Lorsque vous decouvrez une nouvelle extension, il est illusoire de penser que vous vous 
en sortirez seulement avec la documentation fournie (encore faut-il qu'elle existe). Plus 
vous multiplierez vos sources de documentations, plus vous decouvrirez des manieres de 
proceder differentes. Vous decouvrirez des algorithmes puissants auxquels vous n'aviez 
pas pense, des f aeons originales d' utiliser certaines fonctions... 
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N'ayez pas peur d'ecumer les forums de developpeurs pour trouver la reponse a une 
question precise, ou a poser vous-meme votre question. II y aura toujours quelqu'un pour 
vous repondre, vous aider dans la resolution de votre probleme, ou vous proposer une 
solution de secours. 

Quand vous demarrez l'apprentissage d'une extension (ou de n'importe quoi d' autre, 
d'ailleurs), recherchez des tutoriels sur Internet et suivez-les. Vous verrez ainsi differentes 
manieres d'utilisation, ouvrant de nouveaux horizons. 

Avant meme de commencer a apprendre, consultez les blogs de developpeurs : il y en a 
forcement qui ont deja pris la route que vous vous appretez a suivre. Vous trouverez des 
retours d' experiences, ce qui vous permettra de savoir si, oui ou non, telle extension 
merite d'etre apprise ou non... De plus, sur ces blogs, vous trouverez des informations 
que vous n'aviez pas prevues de chercher et qui vous ouvriront peut-etre de nouvelles 
voies. 

Tous les livres peuvent vous apprendre quelque chose en la matiere : vous y trouverez les 
avis et les conseils de quelqu'un qui a vraiment explore un sujet a fond. Ne dedaignez pas 
non plus les magazines specialises. 

Et enfin, certainement la methode la plus efficace et la plus agreable pour obtenir de 
l'aide, c'est de la demander a vos amis developpeurs (si vous en avez). Avez-vous deja 
passe un apres-midi en compagnie d'un ami, a tripoter des lignes de codes, tous les deux 
face a la meme machine ? Chacun apprend de 1' autre et, surtout, vous partagez un 
agreable moment ensemble. Et tout le monde sait que Ton apprend mieux et plus vite, et 
que Ton est globalement plus performant quand on se sent bien. 

1 1 .4 Check-list 

Ce chapitre, indispensable, vous a permis d'aborder les points suivants : 

»/ se connaitre ; 

s/ savoir ce que Ton ne sait pas ; 

*f ce qu'il faut apprendre et pourquoi ; 

</ comment apprendre ; 

>/ l'interet de collaborer (programmer a deux ou plus) ; 

*/ l'interet de profiler de tous les medias mis a disposition. 
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12.1 Webographie 



PHP 

http://php.net/ : le site officiel de PHP toutes versions confondues ; 

http://nexen.net/ : toute l'actualite de PHP ; 

http://afup.org/ : Association francaise des utilisateurs de PHP ; 

http://developpez.com/ : le site des developpeurs francophones ; 

www.developpez.net/forums/ : les forums du site developpez.com/ ; 

http://www.developpez.net/forums/showthread.php?t=6088 : optimisation PHP/MySQL ; 

http://snaps.php.net/ : les versions non stables de PHP dont PHP6 ; 

www.corephp.co.uk/ : l'equipe qui travaille sur PHP ; 

www.phpmvc.net/ : tout sur le MVC {Model View Controller) en PHP 

SQL 

Normes 

http://savage.net.au/SQL/sql-92.bnf.html : la norme SQL92 version HTML ; 
http://savage.net.au/SQL/sql-99.bnf.html : la norme SQL99 version HTML ; 
http://savage.net.au/SQL/sql-2003-l.bnf.html : la norme SQL2003 version HTML (part 1) ; 
http://savage.net.au/SQL/sql-2003-2.bnf.html : la norme SQL2003 version HTML (part 2) ; 
http://savage.net.au/SQL/sql-2003-core-features.html : pour les perfectionnistes ; 
http://savage.net.au/SQL/sql-2003-noncore-features.html : et les insomniaques. 

MySQL 

www.mysql.com/ : le site officiel du SGBD en anglais ; 

www-fr.mysql.com/ : le meme que le precedent et en francais ; 

http://dev.mysql.com/ : la zone des developpeurs avec MySQL6 en telechargement. 

PostgreSQL 

http://www.postgresql.org/ : le site officiel de PostgreSQL ; 
http://www.postgresqlfr.org/ : le site francais pour PostgreSQL ; 
http://docs.postgresqlfr.org/ : la documentation francaise de PostgreSQL. 

Linux 

www.debian.org/ : le site francais le plus complet sur Debian ; 
www.debian-fr.org/ : le site sur Debian et aussi GNU/Linux 
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www.gentoo.org/ : le site officiel de Gentoo ; 

www.gentoo.org/doc/fr/ : la documentation Gentoo ; 

www.gentoofr.org/ : le site Gentoo francophone ; 

http://fluxbox.sourceforge.net/ : le bureau graphique pour Linux, tres leger et tres rapide. 

Autres 

www.cru.fr/ : le Comite reseau des universites contient de tres nombreuses informations 

et de liens, notamment en ce qui concerne LDAP (www.cru.fr/ldap/) ; 

www.openldap.org/ : le site officiel OpenLDAP ; 

http://www.openlaszlo.org/ : Flash version OpenSource, pour les codeurs acharnes ; 

http://tools.ietf.org/html/rfc4517 : LDAP Schema for User Applications ou vous trouverez, 

entre autres, la signification des abreviations (c pour country, etc.) et comment les 

utiliser ; 

http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html : la liste des abreviations des 

pays en deux lettres, trois lettres et leur code numerique ; 

www.fpdf.org/ : le site ou telecharger FPDF et se documenter sur le sujet ; 

http://www.imagemagick.org/script/index.php : le site ou telecharger ImageMagick ; 

www.magickwand.org/ : le site ou telecharger MagickWand ; 

http://milwOrm.com/ : la description de failles, et une mise a jour hebdomadaire ; 

http://www.devshed.com/ : un site web tres bien fourni pour le webmastering 

http://www.pantz.org/ : diverses informations sur beaucoup de domaines en informatique. 

12.2 Fonctions des extensions 

Voici la liste de toutes les fonctions etudiees dans cet ouvrage. 

APC 



^ Tableau 12.1 : APC 




Les fonctions Les arguments 


Leur description 


boot ape add 


Met une variable en cache, sauf si elle a deja 
ete stockee. 


chaTne $key, mixe $valeur [, 
entier $duree de vie ] 
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bool ape clear cache 


Efface le cache APC. Si $cache type vaut 
"user", le cache utilisateur sera nettoye ; sinon, le 




chaTne $cache_type 


cache systeme (les fichiers mis en cache] sera 
nettoye. 


bool ape define constants 


Definit un jeu de constantes. Le parametre $key 
est utilise comme identifiant du jeu de constantes 
et sert a les recuperer en utilisant la fonction 
apc_l oad_constants () . 


chaTne $key, tableau 
$constantes [, bool 
$case sensitive ] 


bool apc_delete 


Efface une variable du cache. Le parametre $key 
correspond a celui utilise pour stacker la variable. 




chaTne $key 


mixe ape fetch 


Recupere une variable depuis le cache. Le 
parametre $key correspond a celui utilise pour 
stacker la variable. 




chaTne $key 


bool ape load content 


Recupere un jeu de constantes depuis le cache. 


chaTne $key [, bool 
$case_sensitive ] 


bool apc_store 


Met une variable en cache. 


chaTne $key, mixe $valeur [, 
entier $duree de vie ] 



Bcompiler 



^g} Tableai 


1 2.2 : Bcompiler 




Les fonctions Les arguments 


Leur description 


bool bcompiler load 


Lit les donnees depuis le fichier compresse 
bzippe $filename et cree les classes depuis le 
bytecode. 




chaTne $filename 


bool bcompiler read 


Lit les donnees depuis un fichier ouvert 
represents par le descripteur $filehandle et 
cree les classes depuis ie bytecode. 


resource $filehandle 
1 
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bool bcompiler write class 


Lit le bytecode d'une classe existante nommee 
$className depuis PHP et 1 ecrit dans le fichier 
ouvert designe par le descripteur $filehandle. 




resource $filehandle, chaine 
$className [, chaine $extends 
] 


bool bcompiler write file 


Compile le fichier $filehandle et ecrit le 
resultat dans le fichier $filename. 




resource $filehandle, 
chaine $filename 


bool bcompiler write footer 


Indique la fin des donnees a compiler. 




resource $filehandle 


bool bcompiler write function 


Ecrit la fonction $functionname dans le fichier 
$filehandle. 


resource $filehandle, chaine 
$functionname 


bool bcompiler write functions from file 


Recherche toutes les fonctions presentes dans le 
fichier $filename et ecrit leur bytecode dans le 
fichier $filehandle. 






bool bcompiler write header 


Ecrit I'en-tete Bcompiler. 




resource $filehandle [, 
chaine $write ver ] 



BZIP2 



^^ Tableai 


12.3 : BZIP2 




Les fonctions Les arguments 


Leur description 


entier bzclose 


Ferme un fichier ouvert avec la fonction 
bzopenQ. 




resource $bzo 


mixte bzcompress 


Compresse une chaine de donnees en fonction 
d un taux de compression et d un facteur de 
travail. 




chaine $donnees 

[, entier $taux compression 

[, entier 

$facteur de travail]] 
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mixte bzdecompress 


Decompresse une chaTne de donnees 
compressee avec la methode bzcompress() . 


chaine $donnees compressees 
[, entier $small] 


tableau bzerror 


Retourne un numero et un message d'erreur 
stockes dans un tableau. 




ressource $bz 


entier bzerrno 


Retourne un numero d'erreur BZIP2. 




ressource $bz 


chaine bzerrstr 


Retourne un message d'erreur BZIP2. 




ressource $bz 


ressource bzopen 


Ouvre un fichier compresse au format BZIP2. 




chaine $nom fichier, 
chaine $mode ouverture 


chaine bzread 


Lit le contenu d'un fichier BZIP2 en fonction 
d un nombre de caracteres determine. 




ressource $bzo 

[, entier $nb caract max] 


entier bzwrite 


Ecrit des donnees dans un fichier BZIP2 ouvert 
via la fonction bzopen (). 




ressource $bzo, 
chaine $donnees 
[, entier $nb caract max] 



Classkit 



^g] Tableai 


12.4 : Classkit 




Les fonctions Leurs arguments 


Leur description 


bool classkit method add 


Ajoute dynamiquement une methode dans une 
classe. 




chaTne $nom classe, 
chaTne $nom methode, 
chaTne $args, 
chaTne $code 
[, entier $drapeaux] 
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bool classkit method redefine 


Redefinit dynamiquement une methode dans 




chaTne $nom classe, 
chaTne $nom methode, 
chaTne $args, 
chaTne $code 
[, entier $drapeaux] 




classkit method remove 


Supprime dynamiquement une methode dans 
une classe. 




chaTne $nom_classe, 
chaTne $nom methode 


bool classkit method rename 


Renomme dynamiquement une methode dans 
une classe. 




chaine $nom classe, 
chaine $nom methode, 
chaine $nouveau nom methode 



DOM 

Fonctions de l'objet DOMDocument 



^g\ Tableai 


12.5 : DOM 




Les fonctions Les arguments Leur description 


DOMElement createElement 


Cree une nouvelle instance de DOMElement. Pour 
integrer ce nceud dans un document, utiliser la 
fonction DOMNode: :appendChi ld(). 


chaTne $name [, chaTne 
$value] 


DOMElement createElementNS 


Cree un nouveau nceud avec un espace de 
nom. Pour integrer ce nceud dans un document, 
utiliser la fonction DOMNode: :appendChild(). 


chaTne $namespaceURI, chaTne 
$qualifiedName [, chaTne 
$value] 


DOMText createTextNode 


Cree un nouveau nceud texte. Pour integrer ce 
nceud dans un document, utiliser la fonction 
DOMNode: :appendChild(). 


chaTne $content 


DOMNodeLi st getEl ementsByTagName 


Retourne une instance de DOMNodeLi st 

contenant tous les elements du document dont le 
nom de balise vaut $name. 




chaTne $name 
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DOMNodeLi st getEl ementsByTagNameNS 


Retourne une instance de DOMNodeLi st 
contenant tous les elements du document dont 
I'espace de nom vaut $namespaceURI et le nom 
vaut $localName. 


chaTne $namespaceURI, chaTne 
$localName 


mixe load 


Charge un fichier XML. Retourne TRUE ou FALSE 
en cas de succes ou d echec. Si appelee 
statiquement, retourne un objet DOMDocument. 




chaTne $filename [, entier 
$option] 


mixe save 


Enregistre un fichier XML depuis une 
representation DOM. Retourne le nombre 
d'octets ecrits ou FALSE en cas d'erreur. 




chaTne $filename 
[, entier $option] 



Fonctions de l'objet DOMElement 



^g} Tableai 


12.6 : Fonctions de l'objet DOMEle 


ment 


Les fonctions Les arguments Leur description 


chaTne getAttribute 


Retourne la valeur de I'attribut dont le nom est 
$name. 


chaTne $name 


bool setAttribute 


Cree un attribut ayant $name pour nom et 
$val u.e pour valeur. 




chaTne $name, chaTne $value 


void setAttributeNS 


Cree un attribut avec $namespaceURI comme 
espace de nom, $qual ifiedname comme nom, 
et $value comme valeur. 




chaTne $namespaceURI, chaTne 
$qualifiedname, chaTne $value 



Fonctions de l'objet DOMNode 



^^ Tableau 12.7 : Fonctions de l'objet DOMNode 


Les fonctions Les arguments 


Leur description 


DOMNode appendChild 


Ajoute un nceud enfant a la fin de la liste des 
noeuds enfants deja existants. 


DOMNode $nouveauNoeud 
1 
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% 


Tableau 12.7 : Fonctions de 


'objet DOMNode 


bool 


hasChildNodes 




Verifie si un nceud a des enfants. 




Aucun argument. 





FPDF 



^^ Tableai 


12.8 : FPDF 


| 


Les fonctions Les arguments Leur description 


AddPage 


Ajoute une nouvelle page au document. Le 
parametre $orientation permet de choisir le 




[chaine $orientation] 


sens de la page : 'P' pour Portrait ou 'L' pour 
Paysage. 


AliasNbPages 


Definit un alias pour le nombre total de pages. 




[chaine $alias] 


Cell 


Ecrit une chaine de caracteres dans une cellule 
et place cette cellule aux coordonnees 
courantes. 




flottant $largeur [, flottant 
$hauteur [, chaine $texte [, 
mixe $bordure [, entier 
$interligne [, chaine 
$alignement [, entier 
$remplissage [, mixe $1 1 en 
]]]]]]] 


Close 


Termine le document PDF. Cette fonction est 
appelee explicitement par la fonction Output. 






GetStringWidth 


Permet de connaTtre la longueur d'une chaine 
de caracteres avec la police de caracteres 
courante. 




Chaine $chaine 


Image 


Place une image dans la page. 


chaine $fichier, flottant $x, 
flottant $y [, flottant 
$largeur [, flottant $hauteur 
[, chaine $type [, mixe $lien 
]]]] 
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Line 


Trace une ligne entre deux points. 


flottant $xl, flottant $yl, 
flottant $x2, flottant $y2 


Ln 


Revient a la ligne (retour chariot). 




flottant $interligne 


Multicell 


Permet de creer un bloc de texte. 


flottant $largeur, flottant 
$hauteur, chaine $texte [, 
mixe $bordure [, chaine 
$al ignement [, entier 
$rempl i ssage ]]] 


Output 


Envoie le document vers la sortie standard (le 
navigateur, le plus souvent) sous forme de 
chaine, ou enregistre le fichier. 


[chaine $nom [, chaine 
$destination ]] 


PageNo 


Renvoie le numero de page courant. 






Rect 


Dessine un rectangle. 


flottant $x, flottant $y, 
flottant $largeur, flottant 
$hauteur [, chaine $style ] 


SetAuthor 


Definit I'auteur du document. 




chaine $auteur 


SetCreator 


Definit le nom du createur. En general, le nom 
de I'application qui a genere le nom du 
document. 




chaine $createur 


SetDrawColor 


Definit la couleur courante des traces et 
contours. 




entier $rouge, entier $vert, 
entier $bleu 


SetFillColor 


Definit la couleur de remplissage courante. 




entier $rouge, entier $vert, 
entier $bleu 
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12.8 : FPDF 




SetFont 




Definit la police de caracteres courante, ainsi 
que sa faille. 




chaine $famille [, chaine 
$style [, flottant $taille ]] 


SetKeywords 




Associe des mots-cles au document. 




chaine $motClef 


SetLineWidth 


Fixe I'epaisseur des traits. La valeur par defaut 
est 0.2. 




flottant $epaisseur 


SetSubject 




Definit le sujet du document. 




chaine $sujet 


SetTitle 


Definit le titre du document. 




chaine $titre 


SetX 




Change la coordonnee x de la position 
courante. 




flottant $x 


SetY 


Change la coordonnee y de la position 
courante. 




flottant $y 


SetXY 


Change les coordonnees de la position 
courante. 




flottant $x, flottant $y 



GD2 



\§\ Tableau 12.9 : GD2 




Les fonctions Les arguments 


Leur description 


tableau getimagesize 


Determine la taille de I'image fournie et en 
retourne les dimensions, le type d'image et une 
chaine type height/width a placer dans une 
balise HTML IMG normale et le type de contenu 
HTTP correspondent. 


chaine $filename [, tableau 
&$imageinfo] 

1 
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entier imagecolorallocate 


Retourne un identifiant de couleur RVB. 




resource $image, entier 
$rouge, entier $vert, entier 
$bleu 


bool imagecopyresized 


Copie une partie de I'image source dans une 
image de destination. 




resource $image destination, 
resource $image source, 
entier $dst x, entier $dst y, 
entier $src x, entier $src y, 
entier $dst largeur, entier 
$dst hauteur, entier 
$src largeur, entier 
$src hauteur 


resource imagecreate 


Cree une nouvelle image a palette. 


entier $largeur, entier 
$hauteur 


resource imagecreatefromgif 


Cree une nouvelle image GIF a partir d'un 
fichier. 


chaTne $filename 


resource imagecreatefromjpeg 


Cree une nouvelle image JPEG a partir d'un 
fichier. 


chaTne $filename 


resource imagecreatefrompng 


Cree une nouvelle image PNG a partir d'un 
fichier. 


chaTne $filename 


resource imagecreatetruecolor 


Cree une nouvelle image trueColor. 


entier $largeur, entier 
$hauteur 


resource imagecreatefromwbmp 


Cree une nouvelle image WBMP a partir d'un 
fichier. 


chaTne $filename 


bool imagedestroy 


Libere la memoire occupee par I'image $image. 


resource $image 
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bool imagefilledrectangle 


Dessine un rectangle rempli avec la couleur 
$couleur. 




resource $image, entier $xl, 
entier $yl, entier $x2, entier 
$y2, entier $couleur 


bool imagegif 


Envoie une image GIF vers un navigateur ou un 
fichier. 




resource $image [, chaTne 
$filename ] 


bool imagejpeg 


Envoie une image JPEG vers un navigateur ou 
un fichier. 




resource $image 

[, chaTne $filename ] 


bool imageline 


Dessine une ligne de couleur $couleur. 




resource $image, entier $xl, 
entier $yl, entier $x2, entier 

$y2, 

entier $couleur 




bool imagepng 


Envoie une image PNG vers un navigateur ou 
un fichier. 




resource $image 

[, chaTne $filename ] 


bool imagesetthickness 


Specifie I'epaisseur d'un trait. 




resource $image, entier 
$epaisseur 


bool imagechaTne 


Dessine une chaTne de caracteres aux 
coordonnees specifiees, et de couleur 
$couleur. 




resource $image, entier 
$font, entier $x, entier $y, 
entier $chaTne, entier 
$couleur 


bool imagewbmp 


Envoie une image WBMP vers un navigateur 
ou un fichier. 




resource $image 

[, chaTne $filename ] 



307 



12 Annexes 








LDAP 








^ Tableau 12.10: LDAP 








Les fonctions Les arguments 


Leur description 






bool ldap add 


Ajoute une entree clans un dossier LDAP. 




resource $link identifier, 
chaTne $dn, 
tableau Sentry 




bool ldap bind 


Authentification au serveur LDAP avec le RDN et 
le mot de passe specifies. 






resource $link identifier 

[, chaTne $bind rdn 

[, chaTne $bind password]] 




entier ldap close 


Alias de ldap unbind (). 




resource $id connexion 




resource ldap connect 


Etablit une connexion avec un serveur LDAP. 






[chaTne $hostname 
[, entier $port]] 




bool ldap_delete 


Supprime une entree du repertoire. 






ressource $id connexion, 
chaTne $dn 




entier ldap errno 


Retourne un numero d'erreur LDAP. 




ressource $id connexion 




chaine ldap error 


Retourne une chaTne qui explique I'erreur LDAP 
generee. 




ressource $id connexion 




chaine ldap err2str 


Recupere un numero d'erreur et le transforme en 
chaTne. 




entier $errno 




chaTne ldap first attribute 


Retourne le premier attribut d'un element. 




resource $id connexion, 
resource $result entry id, 
entier &$ber identifier 
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ressource 1 dap first entry 


Retourne la premiere entree de I'arbre LDAP. 




ressource $id connexion, 
ressource $result 


ressource ldap first reference 


Retourne la premiere reference de I'arbre LDAP 




ressource $id connexion, 
ressource $result 


bool ldap free result 


Libere le resultat afin de liberer de la memoire 
RAM. 




ressource $id resultat 


tableau ldap_get_entries 


Retourne sous forme d'un tableau les entrees 
d'un resultat de recherche. 




resource $id connexion, 
resource $id resultat 


bool ldap modify 


Modifie les entrees d'un arbre LDAP. 




ressource $id connexion, 
chaTne $dn, 
tableau $entrees 




resource ldap search 


Effectue une recherche dans un arbre LDAP. 




ressource $id connexion, 
chaTne $base dn, 
chaTne $filtre 
[, tableau $attributs 
[, entier $attrs seuls 
[, entier $taille max 
[, entier $timelimit 
[, entier $deref]]]]] 


bool ldap set option 


Modifie la valeur d'une option LDAP. 




ressource $id connexion, 

entier $option, 

mixte $nouvelle valeur option 





SOS 



Annexes 



MagickWand 



^g} Tableai 


12.11 : MagickWand 




Les fonctions Leurs arguments 


Leur description 


void DrawBezier 


Dessine une courbe de Bezier en utilisant la 
couleur et le style de trait courants. Le tableau 
$poentier doit contenir au minimum six 
nombres (soit les coordonnees de trois points). 




DrawingWand $d, Tableau 
$poentier 


void DrawCircle 


Dessine un cercle sur I'image. 


DrawingWand $d, float 
$centreX, float $centreY, 
float $RayonX, float $RayonY 


void DrawSetFillAlpha 


Definit I'opacite de la couleur de remplissage. 


DrawingWand $d, Float $alpha 


void DrawSetFillColor 


Definit la couleur de remplissage. 


DrawingWand $d, Pixel Wand $p 


void DrawSetStrokeColor 


Definit la couleur des traits et des contours. 




DrawingWand $d, Pixel Wand $p 


void DrawSetStrokeAlpha 


Definit I'opacite des traits et des contours. 




DrawingWand $d, float $alpha 


void DrawSetStrokeWidth 


Definit I'epaisseur des traits et des contours. 


DrawingWand $d, float 
$epaisseur 


bool MagickAddlmage 


Copie I'image $source sur I'image 
$destination. 




DrawingWand $destination, 
DrawingWand $source 


bool MagickBlurlmage 


Applique un effet de flou. 


DrawingWand $d, float 
$radius, float $sigma [, 
entier channel type ] 
1 
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bool MagickEchoImageBlob 


Extra it le BLOB {Binary Large OBject) dans 
I'image contenue par $d et I'envoie vers la 




DrawingWand $d 


sortie standard qui, sur le Web, devrait etre le 
navigateur de I'utilisateur. 


bool MagickFlattenlmages 


Aplatit la sequence d'image contenue par $d. 




DrawingWand $d 


chaTne MagickGetExceptionChaTne 


Renvoie une chaTne de caracteres decrivant les 
erreurs ou exceptions survenues lors de 
I'execution d'une methode de I'API 
MagickWand. 




DrawingWand $d 


bool MagickGaussianBlurlmage 


Applique un effet de flou gaussien a l'image. 


DrawingWand $d, float 
$radius, float $sigma [, 
entier $channel type ] 


float MagickGetlmageHeight 


Renvoie la hauteur de l'image. 




DrawingWand $d 


float MagickGetlmageWidth 


Renvoie la largeur de I'image. 


DrawingWand $d 


bool MagickMotionBlurlmage 


Applique un effet de flou directionnel sur 
1 image. 


DrawingWand $d float $radius, 
float $sigma, float $angle 


bool MagickNegatelmage 


L'image passe en negatif. 




DrawingWand $d [, bool 
$luminanceSeulement [, entier 
channel_type ]] 


bool MagickOil Paentierlmage 


Applique un effet de peinture a I'huile sur 
1 image. 




DrawingWand $d float $radius 


bool MagickRadialBlurlmage 


Applique un effet de flou radial a I'image. 


DrawingWand $d, float $angle 
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bool MagickRaiselmage 


Applique un effet dit de biseautage, ou des 
ombres et des lumieres sont ajoutees a 1 image, 
donnant vaguement I'impression d'un bouton. 


DrawingWand $d, float 
$largeur, float $hauteur, 
entier $x, entier $y, bool 
$raise 


bool MagickScalelmage 


Redimensionne I'image. 


DrawingWand $d, float 
$largeur, float $hauteur 


bool MagickSetlmageCompressionQual ity 


Definit le taux de compression de I'image. 




DrawingWand $d, float 
$qualite 


bool Magi ckSwirl Image 


Applique un effet tourbillon sur I'image. 




DrawingWand $d, float $degres 


bool MagickWritelmage 


Enregistre I'image sur le disque. 


DrawingWand $d, chaTne 

$filename 
I 


DrawingWand NewDrawingWand 


Cree un objet DrawingWand. 






MagickWand NewMagickWand 


Cree un objet MagickWand. 


1 


PixelWand NewPixelWand 


Cree un objet PixelWand. 


DrawingWand $d, 


bool PixelSetColor 


Definit une couleur grace a une chaTne de 
caracteres (exemples : blue, #0000f f , 
"rgb(0,0,255)", "cmyk(100,100,100,10)". 




DrawingWand $d, ChaTne 
$couleur 
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Les fonctions Leurs arguments Leur description 


PDO construct 


Construit une nouvelle instance permettant la 
connexion au SGBD voulu. Exemple : $oL - 
new pdo($dsn); 


chaTne $dsn 

[, chaTne $username 

[, chaTne $password 

[, tableau $driver options]]] 


entier PD0->exec 


Execute une requete et retourne le nombre de 
lignes affectees. 


chaTne $statement 


PDOStatement PD0->query 


Execute une requete et retourne un jeu de 
resultats en tant qu'objet PDOStatement. 
Exemple: $qqch = $oL->exec($req sql); 


chaTne $statement 


tableau fetchAll 


Retourne sous forme de tableau les resultats de 
la recherche apres execution de query() 
Exemple: $tab = $oL->fetchAl 1 () ; 




[ entier $fetch style 
[, entier $column index]] 



Reflection 



\§\ Tableau 1 2. 1 G 


: Reflection 




Les fonctions Leurs arguments Leur description 


Reflection: :export 


Affiche un tableau qui contient toute 
I'architecture de la classe $nom classe. 




mixte $nom classe, 
bool $retour 


chaTne ReflectionFunction: :getDocComment 


Retourne le commentaire associe a la 
fonction sur laquelle est effectuee la 
reflexion. Le commentaire doit respecter le 
formatage PHPDoc. 




entier ReflectionFunction: :getEndLine 


Retourne le numero de ligne du fichier sur 
laquelle se termine la fonction (accolade 
fermante ' } ' ). 
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^ Tableau 12.1c 


: Reflection 




chaTne ReflectionFunction: :getFileName 


Retoume le nom clu fichier dans lequel se 
trouve la fonction. 




chaTne ReflectionFiinction: :getName 


Retoume le nom de la fonction sur laquelle 
est effectuee la reflexion . 




entier 

Ref 1 ecti onFuncti on : :getNumberOf Parameters 


Retoume le nombre de para metres 
(obligatoires et optionnels) necessaires a la 
fonction. 






entier 

ReflectionFunction: :getNumberOfRequiredParameter 


Retoume le nombre de para metres 
; obligatoires necessaires a la fonction. 




entier ReflectionFunction: :getStartLine 


Retoume le numero de ligne du fichier sur 
laquelle commence la definition de la 
fonction. 






tableau ReflectionFunction: :getStaticVariables 


Retoume sous forme de tableau les 
variables de type statique de la fonction sur 
laquelle est effectuee la reflexion. 






bool ReflectionFunction: :isEntierernal 


Determine si une fonction a ete definie par 
un utilisateur (retoume true) ou si celle-ci 
est interne a PHP (retoume false]. 






bool ReflectionFunction: :isUserDefined 


Determine si une fonction est interne d PHP 
(retoume true| ou si celle-ci a ete definie 
par un utilisateur (retoume false). 






public ReflectionClass getDeclaringClass 


Cree une reflexion sur la classe dans 
laquelle la methode (sur laquelle vous faites 
la reflexion) est definie. 






public bool isAbstract 


Retoume true si la methode est definie en 
tant qu abstraite. 






public bool isConstructor 


Retoume true si la methode est un 
constructeur. 






public bool isDestructor 


Retoume true si la methode est un 
destructeur. 
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^§\ Tableau 12.1c 


: Reflection 




public bool isFinal 


Retourne true si une methode est definie 
en tant que finale. 






public bool isPrivate 


Retourne true si une methode a un acces 
prive. 






public bool isProtected 


Retourne true si une methode a un acces 
protege. 






public bool isPublic 


Retourne true si une methode a un acces 
public. 






public bool isStatic 


Retourne true si une methode est definie 
en tant que statique. 







Runkit 



^^ Tableai 


12.14 : Runkit 




Les fonctions Leurs arguments 


Leur description 


bool runkit class adopt 


Permet d une classe enfant d'heriter d'une 
classe parente. II s agit bien d un heritage 
dynamique. 




chaTne $nom classe enfant, 
chaTne $nom classe parent 


bool runkit class emancipate 


Permet a une classe parente de se liberer de 
toutes ses classes enfants. 


chaTne $nom_classe_parent 


bool runkit constant add 


Ajoute dynamiquement une constante. 




chaTne $nom constante, 
mixte $valeur 


bool runkit constant redefine 


Redefinit dynamiquement une constante. 




chaTne $nom constante, 
mixte $nouvelle valeur 
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12.14 : Runkit 




bool runkit constant remove 


Supprime dynamiquement une constante. 


chaTne $nom constante 


bool runkit function add 


Ajoute dynamiquement une fonction. 


chaTne $nom fonction, 
chaTne $1 i ste arguments, 
chaTne $code 


bool runkit function redefine 


Redefinit dynamiquement une fonction. 




chaTne $nom fonction, 
chaTne $liste arguments, 
chaTne $code 


bool runkit function remove 


Supprime dynamiquement une fonction. 


chaTne $nom fonction 


bool runkit function rename 


Renomme dynamiquement une fonction. 




chaTne $nom fonction, 
chaTne $nouveau nom 


bool runkit method add 


Ajoute dynamiquement une methode dans une 
classe. 


chaTne $nom classe, 
chaTne $nom methode, 
chaTne $args, chaTne $code 
[, entier $drapeaux] 


bool runkit method redefine 


Redefinit dynamiquement une methode dans 
une classe. 


chaTne $nom classe, 
chaTne $nom methode, 
chaTne $args, chaTne $code 
[, entier $drapeaux] 


bool runkit method remove 


Supprime dynamiquement une methode dans 
une classe. 


chaTne $nom classe, 
chaTne $nom methode 


bool runkit method rename 


Renomme dynamiquement une methode dans 
une classe. 




chaTne $nom_classe, 
chaTne $nom methode, 
chaTne $nouveau nom 
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ZIP 






^ Tableau 12.15 : ZIP 


1 




Les fonctions Leurs arguments 


Leur description 




bool ZipArchive: :addFile 


Ajoute un fichier dans une archive ZIP. 






chaTne $nom fichier 

[, chaine $nom dans archive] 




bool ZipArchive: :addFromChaTne 


Ajoute une chaTne ($contenu) dans un fichier 
($nom dans archive) qui sera place dans 
I'archive ouverte. 






chaine $nom dans archive 
, chaine $contenu 




bool ZipArchive: :close 


Ferme une archive ZIP ouverte via la fonction 
addFile(). 






void 




mixte ZipArchive: :extractTo 


Extrait un ou plusieurs fichiers d'une archive ZIP. 




chaTne $rep dest 
[, mixte $entrees] 




chaTne ZipArchive: :getArchiveComment 


Retourne le commentaire associe a une archive 
ZIP. 




| 




mixte ZipArchive: :locateName 


Localise I'emplacement d'un fichier dans une 
archive ZIP. 






chaTne $nom fichier 
[, entier $drapeaux] 




mixte ZipArchive: :open 


Ouvre une archive ZIP. 






chaTne nom fichier 
[, entier drapeaux] 




bool ZipArchive: :renamelndex 


Renomme I'index d'un fichier situe dans une 
archive ZIP. 






entier $index, 
chaTne $nouveau nom 




bool ZipArchive: :renameName 


Renomme le nom d'un fichier situe dans une 
archive ZIP. 






chaTne $nom actuel , 
chaTne $nouveau nom 




mixte ZipArchive: :setArchiveComment 


Depose un commentaire associe a une archive 
ZIP. 






chaTne $commentaire 
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ZUB 



^g} Tableai 


12.16 : ZUB 




Les fonctions Les arguments Leur description 


boot gzclose 


Ferme un fichier GZIP ouvert via la fonction 
gzopen (). 


ressource $gzo 


chaTne gzcompress 


Compresse les donnees selon un taux de 
compression. 




chaTne $donnees 

[, entier $taux compression] 


chaTne gzdeflate 


Compresse une chaTne via une methode qui 
utilise simultanement 1 algorithme LZ77 et le 
codage de Huffman. 




chaTne $donnees 
[, entier $niveau] 


chaTne gzgetc 


Retourne un caractere des donnees contenues 
dans le fichier ZLIB. 




ressource $zp 


chaTne gzgets 


Retourne une chaTne de caracteres des donnees 
contenues dans le fichier ZLIB. 




ressource $zp 
, entier $length 


chaTne gzgetss 


Retourne une chaTne de caracteres des donnees 
contenues dans le fichier ZLIB et en supprimant 
les balises HTML. 




ressource $zp, 
entier $length 
[, chaTne $balises permises] 


chaTne gzinflate 


Decompresse une chaTne compressee via la 
fonction gzdeflate(). 


chaTne $data 

[, entier $taille] 


ressource gzopen 


Ouvre un fichier compresse avec I'algorithme 
ZLIB. 


chaTne $nom fichier, 

chaTne $mode 

[, entier $use include path] 


entier gzpassthru 


Lit les donnees non lues dans un fichier ZLIB. 




resource $zp 
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chaTne gzread 


Lit le contenu d'un fichier ZLIB. 




ressource $gzo 
, entier $taille 


bool gzrewind 


Place le curseur au debut du fichier ZLIB. 




ressource $gzo 


entier gzseek 


Place le curseur a un endroit precis du fichier 
ZLIB. 




ressource $gzo, 
entier $emplacement 


entier gztell 


Retourne la position a laquelle se trouve le 
curseur dans le fichier ZLIB. 




resource $zp 


chaTne gzuncompress 


Decompresse une chaTne compressee via la 
fonction gzcompress(). 




chaTne $donnees 
[, entier $taille] 


entier gzwrite 


Ecrit dans un fichier ZLIB. 




ressource $gzo, 
chaTne $chaine 
[, entier $taille] 
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